Multi Card Integration

Pre-requisites

• Setup your Hands In account - You must have created and set up a Hands In account before following this tutorial
• API Authentication - You must have retrieved your sandbox or live API key

How it works

Server-to-server integration steps

1. Create a multi card payment session — POST /v1/multi-card-payments with the total in amountMoney, a unique idempotencyKey, and optionally your own referenceId. See Create a Multi Card Payment Session for full request and response examples.
2. Send the customer to the hosted checkout — take the url from the response and redirect the customer, open it in a new tab, embed it in an <iframe>, or send it to them by email or SMS.
3. Receive the outcome — subscribe to the multi card webhook events so your system is told when the session is approved, completed, expired or cancelled. If you cannot receive webhooks, poll Retrieve a Multi Card Payment Session instead.
4. Reconcile the individual card payments — each payment carries its own referenceId. See Reconcile Multi Card Payments.