Skip to content

Create a Payin Order

Request URL

MethodURL
POST/api/pay/payment/create/v1

Headers

Header ParameterDescription
timestampRequest timestamp
nonceRandom value
countryCountry code (e.g., ID)
app_codeApplication ID

Supported Payment Types (paymentType)

Payment Method NamePaymentType (Parameter)
PaymentLink501(Cashier counter, featuring all available payment methods, including E-Wallet, VA, and QRIS.)
E-Wallet502(Cashier counter, payment method including electronic wallets, Dana, etc.)
VA503 (Cashier counter, including payment methods such as Va and BNI.)
QRIS504 (Cashier counter, with QRIS payment method included)
QRIS-Direct505 (QRIS direct connection payment method)
VA-Direct506 (VA direct payment method)

Support the expansion list (channel) of payment methods

支付方式channel
503BRI,MANDIRI,CIMB
502DANA,LINKAJA
506BRI,MANDIRI,CIMB

additionalInfo (Additional Fields) Description

Field NameTypeRequiredDescription
----

Request Parameters

FieldTypeRequiredLengthDescription
merchantOrderNoStringyes32Merchant order number
paymentTypeIntyesPayment type: 501,502,503,504,505,506
amountStringyes20Collection amount (in IDR), integer only
realNameStringyes64User’s full name
emailStringyes50User’s email (must match regex format)
phoneStringyesPhone number, starts with 08, 10–13 digits
channelStringnoPayment method extension field. When the specific payment method is 502, 503, or 506, it must be filled in. For details, please refer to the 【List of Supported Payment Method Extensions】
signStringyesSignature
callbackUrlStringno200Callback URL
redirectUrlStringno255When results are available, the customer can be redirected to that address.

Sample Request

{
"merchantOrderNo": "OrderNoExample",
"realName": "TeemoPay",
"amount": "60000",
"callbackUrl": "https://www.callbackexample.com",
"paymentType": 502,
"email": "TeemoPay@example.com",
"channel": "DANA",
"phone": "0800000000",
"sign": "YOUR_SIGN"
}

Response Parameters

FieldTypeRequiredLengthDescription
merchantOrderNoStringyes32Merchant order number
tradeNoStringyes32Platform order number
amountStringyes32Transaction amount
paymentTypeIntyes3Payment type
paymentInfoStringyes32Main payment info (e.g., payment code or number)
additionalInfoJSONObjectnoAdditional (extended) information
statusIntyesCollection status: 1 = Success, 3 = Failed
errorMsgStringnoError message (returned only when failed)

Sample Response

{
"msg": "success",
"traceId": "747bbf80261844ed85b809212aab0d81.85.17422898158610299",
"code": 200,
"data": {
"amount": "60000.00",
"tradeNo": "TS2501010001ID0000000000000000",
"additionalInfo": {
},
"merchantOrderNo": "OrderNoExample",
"paymentInfo": "https://www.paymentLinkExample.com",
"paymentType": 502,
"status": 1
}
}