Overview
This document gives a description of the RESTful web services exposed on the Creditswitch Platform which enables business partners sell different products and track their account. Our RESTful web service mainly uses data in JSON format for both input and output operations.
Http request header should be set to application/json or the corresponding data type. For technical assistance with the CSW API contact us at support@creditswitch.com. The subject line should be CSW API:(ISSUE SNIPPET) to enable swift response and support.
🔗 Integration Flow
This section describes the recommended integration flow — helping reduce the risk of disputed transactions and boosting customer confidence.
🔧️ Step One
If your service supports customer validation, it should be performed first. This ensures the customer is correctly identified on the provider platform and that the desired products are currently available.
🚀 Step Two
Once Step 1 is completed successfully, send a Vend request. If the HTTP response status is OK, check the status field — it will indicate whether the request was successful. Either way, the request has been processed.
⚠️ Step Three
Alternative outcomes in Step 2 include timeouts, connection issues, or other defined errors. Handle these gracefully:
- If an error occurs, you can safely resend the Vend request — just be sure to generate a new request ID.
- If a new response with HTTP status
OKis received, you may consider the vend process completed.
📄 Step Four
(Optional) Re-validate the customer if needed. This ensures continued consistency in user identity and availability of desired products at this final step.
