Recipe 1: Merchant Gets Paid (Payments)

Important

For this payments flow:

• No session minting is required
• No token encryption is required
• No transaction id encryption is required

Use these wrapper endpoints:

1. POST /payments/request
2. POST /payments/status
3. POST /payments/cancel (only when needed)

Flow

1. Create payment request
2. Capture payment_details_id from response
3. Poll payment status with payment_details_id
4. Optionally cancel with payment_details_id

Create Request

Endpoint: POST /payments/request

{
  "api_key": "sandbox_api_key",
  "transaction_request": {
    "amount": "50.00",
    "currency": "USD",
    "customer_reference": "cust_merchant_0042"
  }
}

Expected success response includes a payment_details_id to use for status/cancel.

Status Check

Endpoint: POST /payments/status

{
  "api_key": "sandbox_api_key",
  "payment_details_id": "pay_123"
}

Cancel Request (Optional)

Endpoint: POST /payments/cancel

{
  "api_key": "sandbox_api_key",
  "payment_details_id": "pay_123"
}