Card

Card

Card payments are a widely recognized and trusted method, allowing customers to pay using their credit or debit cards. CrissCross enables seamless integration with major card providers, ensuring a secure and efficient checkout experience for your customers.

Introduction

Card payments are essential for any online business, providing a familiar and straightforward option for customers to complete their purchases. Integrating Card payments with CrissCross allows you to offer various card types, including Visa, Mastercard, American Express, and Discover, while leveraging CrissCross’s secure infrastructure to process transactions efficiently. This guide explains how to integrate Card payments into your application or website using CrissCross.

Pre-requisites

Before accepting Card payments through CrissCross, ensure you meet the following requirements:

• CrissCross integration:
  You have integrated with CrissCross using our hosted checkout. As your merchant of record, CrissCross handles all payment provider relationships, so you can accept card payments without needing to register with individual card processors or establish commercial relationships with payment providers.

• Card payments enabled on your account:
  Card payments are enabled for your account during onboarding. Contact your account manager if you want to add them.

Ways to integrate Card with CrissCross

Card payments are accepted through CrissCross hosted checkout. With this option:

• There’s minimal development required on your end.
• CrissCross automatically displays the Card payment method during checkout, based on what is enabled for your account.
• Card data is captured on the CrissCross-hosted page, keeping your PCI scope to a minimum.

Creating a checkout session

To create a checkout session, make a POST request to the /v1/checkout/session endpoint.

curl -X POST https://api.crisscross.money/v1/checkout/session \
     -H "Content-Type: application/json" \
     -d '{
  "merchantId": "YOUR_MERCHANT_ID",
  "merchantReference": "ORDER67890",
  "amount": 20000,
  "currency": "ZAR",
  "integrationType": "hosted",
  "redirectUrl": "https://merchant.com/redirect",
  "payerDetails": {
    "emailAddress": "[email protected]",
    "location": "ZAF",
    "fullName": "Siyanda Mthembu",
    "phoneNumber": "0723456789"
  }
}'

Response:

{
  "sessionId": "01951c8a-7c3d-7e1f-9d4a-2b3c4d5e6f70",
  "paymentLink": "https://checkout.payos.money/session/01951c8a-7c3d-7e1f-9d4a-2b3c4d5e6f70?signature=kRe8vQZ2mXpL7nT4wYbHs1JdA0uCgFiO6ExNq3ZrPyM"
}

In this example:

• The sessionId in the response references this specific checkout session, which can be used to complete the payment or track its status.

Handling the payment

After creating a session, direct your customer to the paymentLink. The hosted checkout captures the card details, runs any required authentication (e.g. 3D Secure), and completes the payment. Track the outcome via webhooks or by polling GET /v1/payment/{transactionId}.

Supported regions / countries

Card payments through CrissCross are supported in the following regions and countries:

(Note: Support for additional regions and countries may be added in the future. Check CrissCross documentation or contact support for updates.)

Supported workflows and services

The following table outlines the workflows and services supported when using Card payments with CrissCross:

Ensuring a seamless and secure payment experience

To optimise your integration and ensure customer satisfaction, consider the following best practices:

• Prioritise security and compliance:
  Protecting customer data is paramount. CrissCross adheres to PCI DSS standards and other relevant regulations. Ensure you also follow any additional region-specific compliance requirements, especially when handling sensitive financial information across different countries.

• Focus on a smooth user experience:
  Present payment methods clearly and intuitively. When customers reach the checkout stage, they should easily recognise and trust the payment options available. For example, highlight local payment methods prominently in regions where they are popular.

• Monitor performance and reliability:
  Keep an eye on transaction success rates and processing times. CrissCross’s dashboard provides insights into each payment method’s performance, enabling you to resolve any latency or downtime issues quickly to maintain customer trust.

• Scale with your business growth:
  As your business expands, your payment needs may evolve. CrissCross’s flexible infrastructure makes it easy to add new payment methods, integrate with additional PSPs, or adjust your configurations to handle increased transaction volumes without compromising performance.

Additional resources and next steps

With CrissCross, managing and enabling diverse payment methods becomes more efficient and manageable. For detailed integration instructions, coding examples, and advanced customisation options, explore these resources:

• CrissCross API documentation
  Dive deeper into CrissCross’s API endpoints and discover how to implement server-to-server integrations, handle advanced payment flows, and manage transactions programmatically.

• Integration guides
  Review step-by-step guides for integrating with CrissCross, ensuring a smooth setup experience regardless of your technical background or business model.

By configuring payment methods with CrissCross, you can offer your customers a streamlined and secure checkout experience tailored to their preferences and regional payment norms. Continuously refine your payment configurations and leverage CrissCross’s robust features to stay agile in an ever-evolving e-commerce landscape.