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": "081234567890",
"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
}
}