POST
/
payments
/
checkout
Create Payment Checkout
curl --request POST \
  --url https://api.dompetx.com/v1/payments/checkout \
  --header 'Content-Type: application/json' \
  --header 'X-DOMPAY-API-Key: <api-key>' \
  --header 'X-DOMPAY-Signature: <api-key>' \
  --header 'X-DOMPAY-Timestamp: <api-key>' \
  --data '
{
  "amount": 5000,
  "currency": "IDR",
  "reference": "ORDER123456",
  "metadata": {}
}
'

​
Overview

Create a payment checkout session that allows customers to select payment method and complete payment.

​
Request Body

{
  "amount": 5000,
  "currency": "IDR",
  "reference": "ORDER16JAN2026",
  "metadata": {
    "customer_id": "CUST-456",
    "order_type": "retail"
  }
}

​
Response Example

{
  "amount": 5000,
  "createdAt": "2026-01-16T10:33:15+07:00",
  "currency": "IDR",
  "expiresAt": "2026-01-17T10:33:15+07:00",
  "id": "7f3e4175-9f9c-49f5-947e-5b65b0c509e3",
  "status": "pending",
  "payment_link": "https://checkout.dompetx.com/checkout/7f3e4175-9f9c-49f5-947e-5b65b0c509e3"
}

​
Features

  • Multiple payment method selection
  • Customizable checkout page
  • Automatic expiration after 24 hours
  • Real-time payment status updates

Authorizations

​
X-DOMPAY-API-Key
string
header
required
​
X-DOMPAY-Signature
string
header
required
​
X-DOMPAY-Timestamp
string
header
required

Body

application/json
​
amount
number
required
Example:

5000

​
currency
string
required
Example:

"IDR"

​
reference
string
required
Example:

"ORDER123456"

​
metadata
object

Response

201

Checkout created successfully