All requests require the standard x-api-key + x-timestamp headers — see Authentication.
Create Payment
POST /api/v1/payments
Request body
| Field | Type | Required | Default | Notes |
|---|
price | number | Yes | — | Amount in IDR. Minimum 15,000. |
playerId | string | Yes | — | Your payer/player identifier. |
flow | string | No | embed | Checkout flow. |
expiresIn | integer | No | 900 | Seconds until expiry. Maximum 3600. |
curl -X POST https://live.launcx.com/api/v1/payments \
-H "Content-Type: application/json" \
-H "x-api-key: {{your-v3-api-key}}" \
-H "x-timestamp: {{unix_timestamp_in_milliseconds}}" \
-d '{
"price": 20000,
"playerId": "payer_id",
"flow": "embed",
"expiresIn": 900
}'
Response
{
"success": true,
"data": {
"orderId": "130e1a1d-9e61-42ca-b57a-4854eae7878f",
"checkoutUrl": "https://payment.launcx.com/order/130e1a1d-9e61-42ca-b57a-4854eae7878f",
"qrPayload": "QR_CODE",
"playerId": "payer_id",
"totalAmount": 20000
}
}
Get Payment
GET /api/v3/payments/{id}
This endpoint is under /api/v3, not /api/v1.
curl -X GET https://live.launcx.com/api/v3/payments/{id} \
-H "x-api-key: {{your-v3-api-key}}" \
-H "x-timestamp: {{unix_timestamp_in_milliseconds}}"
Response
| Field | Type | Notes |
|---|
id | string | Payment UUID. |
client_id | string | Your client UUID. |
payer_id | string | The playerId from creation. |
amount | string | Decimal string (precision-preserving). |
currency | string | IDR. |
expired_at | string | ISO 8601 UTC. |
status | string | PENDING | SUCCESS | EXPIRED | FAILED. |
platform_fee | string | Decimal string. |
net_amount | string | Decimal string. |
paid_at | string | null | ISO 8601 UTC. |
settled_at | string | null | ISO 8601 UTC. |
retrieval_reference_no | string | null | |
created_at | string | ISO 8601 UTC. |
updated_at | string | ISO 8601 UTC. |
client_wallet_name | string | null | Present if a wallet name is configured. |
