Quickstart (API)

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

1. Create a payment session

You can simply send a POST request to the Multi Card API endpoint or the Group Payment API endpoint

// request 
curl --request POST \
     --url https://sandbox.handsin.com/v1/multi-card-payments \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --header 'x-api-key: <your-api-key>' \
     --data '
{
  "amountMoney": {
    "currency": "USD",
    "amount": 10000
  },
  "idempotencyKey": "<randomstring>"
}
'

2. Share or embed the payment session URL

The response will return a JSON object with an url property which you can then share with your customers by either embedding it as an IFRAME on your website or via link sharing such as email or SMS.


{
  "merchantId": "your merchant ID",
  "id": "Payment Session ID",
  "status": "APPROVED",
  "url": "https://sandbox.checkout.handsin.com/m/...", // send this to your customer
  "totalMoney": {
    "amount": 100,
    "currency": "AED"
  },
  "amountMoney": {
    "amount": 100,
    "currency": "AED"
  },
  "lineItems": [...],
  "pageOptions": {...},
}