Skip to main content
POST
/
commands
/
pay
Create Payment Request
curl --request POST \
  --url http://{IP_ADDRESS}:{PORT}/commands/pay \
  --header 'Content-Type: application/json' \
  --header 'X-API-KEY: <api-key>' \
  --header 'provider: <provider>' \
  --data '
{
  "order_id": "test1223323",
  "terminal_id": "10362517",
  "request_amount": 100,
  "payment_method": "QRIS"
}
'
{
  "order_id": "test1223323",
  "terminal_id": "10362517",
  "terminal_reference": "1750407594445|1750407594",
  "payment_method": "QRIS",
  "amount": 100,
  "currency": "IDR",
  "transaction_date": "2025-06-20T08:19:54.000Z",
  "status": "SUCCESS"
}

Documentation Index

Fetch the complete documentation index at: https://terminal-docs.xendit.co/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
X-API-KEY
string
header
required

API key for authentication

Headers

​
provider
enum<string>
required

Provider name.

Available options:
BRI,
NTT,
CASHUP,
SHC
​
simulation
boolean

Simulation/mock response flag.

​
pretty-print
boolean

Json Pretty Formatter flag.

Body

application/json
​
terminal_id
string
required

Terminal's ID.

Required string length: 1 - 50
Example:

"10362517"

​
order_id
string
required

Merchant's order ID. Use only letters and numbers (alphanumeric). Hyphens, underscores, and other special characters are not allowed and may cause the transaction to fail to execute or complete.

Required string length: 1 - 100
Pattern: ^[A-Za-z0-9]+$
Example:

"test1223323"

​
request_amount
number<double>
required

Intended amount to be collected from end user.

Required range: x >= 1
Example:

100

​
payment_method
enum<string>
required

Available payment methods

Available options:
INSERT_CARD,
CONTACTLESS,
BRIZZI,
QRIS,
CARD,
QR,
ALIPAY_PLUS,
WECHATPAY_CIL,
WECHATPAY_OCGT,
TRUEMONEY,
LINEPAY,
SHOPEEPAY,
SABUYMONEY,
MAXME,
BBL_QRCS
Example:

"QRIS"

Response

Successful payment response.

​
status
enum<string>
required

Transaction status values

Available options:
SUCCESS,
FAILED
Example:

"SUCCESS"

​
order_id
string
required

Merchant's order ID. Uses only letters and numbers (alphanumeric). Hyphens, underscores, and other special characters are not allowed and may cause the transaction to fail to execute or complete.

Example:

"test1223323"

​
terminal_reference
string

Reference for Void & Receipt.

Example:

"1750407594445|1750407594"

​
payment_method
enum<string>

Available payment methods

Available options:
CARD,
EWALLET,
QRIS
Example:

"QRIS"

​
amount
number<double>

The transaction amount.

Required range: x >= 0
Example:

100

​
currency
string

The transaction currency (ISO 4217).

Required string length: 3
Example:

"IDR"

​
transaction_date
string<date-time>

The date and time of the transaction.

Example:

"2025-06-20T08:19:54.000Z"