Skip to content

Create Cashier

Request URL

methodurl
POST/api/checkout/payment/create

Headers

Header ParameterDescription
timestampRequest timestamp
nonceRandom value
countryAR
appCodeApplication ID

Request Parameters

FieldTypeRequiredLengthDescription
merchantOrderNoStringYes32Merchant order number
paymentTypeIntNoIf not passed, configured payment methods will be returned; Payment methods: 【901 (QR), 902 (CVU), 905 (Rapipago), 906 (Pagofacil)】
amountStringYes20Amount (Integer only). Example: 1000.

Amount Reduction Scenario: The amount must be a multiple of 100, otherwise the system will block the submission.
Examples: 100, 200, 300, 400
Invalid examples: 101, 110, 210
expirationTimeStringNo20Expiration time, millisecond-level timestamp, e.g.: 1735660800000 [Default: one day, minimum: 10 minutes, maximum: seven days].

Amount Reduction Scenario: The expiration time will be set to 15 minutes after submission.
idTypeStringYes50Personal identification type: DNI, CUIT, CUIL. 【It is recommended to use CUIT】
idCardNumberStringYes11Personal Identification Number: DNI (7 or 8 digits), CUIT (11 digits, the first digit must be 2 or 3), CUIL (11 digits)
phoneStringNo1010-digit number without area code
emailStringNo50Payer’s email address; Must comply with regular expression rules
realNameStringYes50Payer’s name. Please capitalize all letters.
callbackUrlStringNo200Collection callback URL (if not provided, use the callback URL configured in the merchant’s backend)
remarkStringNo200Remark
signStringYesSignature
request
{
"merchantOrderNo": "ceshi-test",
"paymentType": 901,
"amount": "1000",
"expirationTime": "1765943486000",
"idType": "CUIT",
"idCardNumber": "31231233434",
"phone": "3111111111",
"email": "213@123.com",
"realName": "ZHANG SAN",
"callbackUrl": "https://www.callbackexample.com",
"sign": "YOUR_SIGN"
}

Response Parameters

ParameterTypeRequiredLengthDescription
merchantOrderNoStringyes32Merchant order number
tradeNoStringyesPlatform order number
amountStringyesOrder transaction amount
statusIntyesCollection status: 0 = processing, 3 = failed
checkoutLinkStringyesCheckout page URL
expirationTimeStringyesCheckout page expiration time
errorMsgStringnoError message, returned when failed
response
{
"code": 200,
"data": {
"merchantOrderNo": "ceshi-test",
"tradeNo": "TS2509080002ARexample754",
"amount": "100",
"status": 0,
"checkoutLink": "https://test-ar-payin.teemopay.com/#/?tradeNo=TS2509080002ARexample754",
"expirationTime": "2025-09-17 13:53:45.959",
"errorMsg": null
},
"msg": "success",
"traceId": "1e7142b1c2cf47479ccfdbb1ecba5242.94.17579264259380029"
}

Error Codes

Error CodeError MessageHandling Solution
412Please try again laterPlease try again later
414*Please change the corresponding parameter
416Application not foundapp_code error, please change
424This payment method is not configuredPayment method not configured, please contact us
426merchant order duplicatePlease change merchant order number
427The callback notification address for collection must not be empty.Collection callback URL not configured, please configure
438Phone number is errorPlease check and change phone number
460The current payment method is unavailable.Current payment method unavailable, please change
473Merchant joint verification error: *Configuration error, please contact us
478Invalid format for expireTimeUse UTC timestamp
479The id type is error (Example: DNI, CUIT, CUIL. It is recommended to use CUIT.)Use one of (DNI, CUIT, CUIL), 【It is recommended to use CUIT】
480ID card number error (DNI: must be 7–8 digits in length; CUIL: must be 11 digits in length; CUIT: must be 11 digits in length, with the first digit restricted to 2 or 3)DNI (7 or 8 digits), CUIT (11 digits, first digit must be 2 or 3), CUIL (11 digits)
500Business ErrorPlease contact us
response
{
"code": 426,
"data": null,
"msg": "merchant order duplicate",
"traceId": "747bbf80261844ed85b809212aab0d81.85.17422898158610298"
}