🔎 How to Retrieve a Multi Card Payment Session

After creating a multi card session, you can retrieve information about that session by sending a GET request to https://api.sandbox.handsin.com/v1/multi-card-payments/:multiCardId

You will need the id of the multi card session you want to retrieve.

🧾 Fetch Multi Card Session Request Examples

curl --request GET \
  --url https://api.sandbox.handsin.com/v1/multi-card-payments/example-multi-card-id-123 \
  --header "Accept: application/json" \
  --header "x-api-key: <your-api-key>"

const url =
  "https://api.sandbox.handsin.com/v1/multi-card-payments/example-multi-card-id-123";

try {
  const response = await fetch(url, {
    method: "GET",
    headers: {
      Accept: "application/json",
      "x-api-key": "<your-api-key>",
    },
  });

  if (!response.ok) {
    throw new Error(`Response status: ${response.status}`);
  }

  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error("Request failed:", error.message);
}

import requests

url = "https://api.sandbox.handsin.com/v1/multi-card-payments/example-multi-card-id-123"
headers = {
    "Accept": "application/json",
    "x-api-key": "<your-api-key>"
}

try:
    response = requests.get(url, headers=headers)
    response.raise_for_status()
    print(response.json())
except requests.exceptions.RequestException as e:
    print(f"Request failed: {e}")

$headers = @{
  "Accept" = "application/json"
  "x-api-key" = "<your-api-key>"
}

try {
  $response = Invoke-RestMethod -Uri "https://api.sandbox.handsin.com/v1/multi-card-payments/example-multi-card-id-123" \
    -Method GET -Headers $headers
  $response
} catch {
  Write-Host "Request failed: $($_.Exception.Message)"
}

✅ Example Response

{
  "id": "example-multi-card-id-123",
  "amountMoney": {
    "amount": 1000,
    "currency": "GBP"
  },
  "totalMoney": {
    "amount": 1000,
    "currency": "GBP"
  },
  "status": "PENDING",
  "autocomplete": true,
  "enablePartialPayment": false,
  "url": "https://checkout.sandbox.handsin.com/r/example-multi-card-redirect-id",
  "merchantId": "your-merchant-id",
  "customerId": "example-customer-id",
  "createdAt": "2025-04-23T10:27:14.000Z",
  "updatedAt": "2025-04-23T10:27:14.000Z"
}

You've now learned how to retrieve a Multi Card Payment Session using the Hands In API. This allows you to programmatically track payment progress, status, and other session details.

👉 Next, learn how to Reconcile a Multi Card Session

Retrieve a Multi Card Payment Session

🔎 How to Retrieve a Multi Card Payment Session

🧾 Fetch Multi Card Session Request Examples

✅ Example Response

On this page