Create a payment intent

Creates a new payment intent for a customer to purchase a plan. Requires an idempotency key to prevent duplicate charges. Returns client secret and publishable key needed for frontend integration.

POST /v1/sdk/payment-intents

Create a payment intent

cURL

curl --request POST \
  --url https://api.example.com/v1/sdk/payment-intents \
  --header 'Content-Type: application/json' \
  --header 'idempotency-key: <idempotency-key>' \
  --data '
{
  "customerRef": "<string>",
  "amount": 5000050,
  "currency": "<string>",
  "description": "<string>",
  "planRef": "<string>",
  "pricingTier": "<string>",
  "productRef": "<string>",
  "purpose": "product"
}
'

Headers

idempotency-key · string · required

Unique idempotency key to prevent duplicate payments (required)

Body

application/json

Payment intent creation data

customerRef · string · required

Minimum string length: 1

amount · integer

Required range: 100 < x < 10000000

currency · string

description · string

Maximum string length: 500

planRef · string

Minimum string length: 1

pricingTier · string

productRef · string

Minimum string length: 1

purpose · enum<string> · default: product

Available options: product, credit_topup, usage_billing

Response

201

application/json

Payment intent created successfully