Getting Started

Testing Connectivity

Verifying your connection to the CrissCross API

Overview

Testing connectivity to the CrissCross API is a crucial step in ensuring that your application is properly integrated and ready for further development and deployment. This guide provides a method to verify your connection, emphasizing our enterprise-focused, white-glove onboarding approach.

Making a Test API Call

To test your API connectivity, you can make a simple request to any lightweight endpoint that requires authentication. Here are examples for each service:

Collect API Example

Test connectivity to the Collect API by fetching a checkout session:

$curl -X GET "https://api.crisscross.money/v1/checkout/session?sessionId=YOUR_SESSION_ID" \
>  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

Expected Response:

1{
2  "session": {
3    "id": "0d3f1d6c-1c49-4b89-9db6-1fdc06f24c8a",
4    "merchantId": "1b2a3d4c-5e6f-7a8b-9c0d-1e2f3a4b5c6d",
5    "merchantReference": "ORDER12345",
6    "amount": 15000,
7    "currency": "ZAR",
8    "integrationType": "hosted"
9  }
10}

Exchange API Example

Test connectivity to the Exchange API by fetching account balances:

$curl -X GET "https://api.crisscross.money/v1/exchange/accounts" \
>  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

Payouts API Example

Test connectivity to the Payouts API by fetching payout history:

$curl -X GET "https://api.crisscross.money/v1/payouts?merchantIds=YOUR_MERCHANT_ID" \
>  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

Troubleshooting Connectivity Issues

If you encounter issues, consider the following steps:

  • Verify Access Token: Ensure that your OAuth 2.0 access token is correct and has the necessary permissions.
  • Check Network Settings: Confirm that there are no firewalls or network policies blocking access to the CrissCross API.
  • Use Diagnostic Tools: Tools like Postman or Wireshark can help diagnose connectivity or authentication issues.

Contact Support

If problems persist, contact CrissCross support with details of your request and any errors you receive for further assistance. Our senior solutions engineers are available to provide personalized support and ensure your integration meets your business requirements.