跳转到内容

收银台创建

API TEST CONSOLE

模拟请求

TEST ONLY

测试环境下配置参数并发送请求

POST/trade/checkout/create

请求鉴权

待配置

私钥仅在浏览器内用于生成 authorization,不会随请求发送或保存

请求头

请求参数 application/json

响应结果

Response
发送请求后,响应状态、耗时和 JSON 将显示在这里。

认证信息仅保留在当前页面内存中,不会写入本地存储。

复制 cURL 不会发送请求

POST/trade/checkout/create

请求头

公共请求头。

支付方式参数

paymentType
QR
CVU
RAPIPAGO

请求参数

字段类型必填最大长度说明
merchantOrderNoString是32商户订单号
transactionAmountString是20收款金额 金额必须为 10 的倍数。
paymentTypeString否32支付方式
idTypeString是50证件类型:DNI、CUIT、CUIL、USER_REF
userIdCardString是50证件号码。DNI 为 7~8 位数字;CUIT 为 11 位且首位为 2 或 3;CUIL 为 11 位数字;USER_REF 为 1~50 位字母或数字
userNameString是64用户姓名
userPhoneString否10用户手机号码,10 位数字
userEmailString否50用户邮箱
expireTimeString否-订单过期时间(国家当地时间)
descriptionString否100说明
paymentCallbackUrlString否200代收回调地址

请求示例

{
"merchantOrderNo": "CHECKOUT202609170001",
"transactionAmount": "100.00",
"paymentType": "QR",
"idType": "DNI",
"userIdCard": "12345678",
"userName": "TEST USER",
"userPhone": "1123456789",
"description": "Test checkout",
"paymentCallbackUrl": "https://merchant.example/callback"
}

响应参数

字段类型必填最大长度说明
codeint是-状态码,非 200 代表异常
dataObject是-响应体
data.merchantOrderNoString是32商户订单号
data.tradeNoString是32平台单号
data.transactionAmountString是20收款金额
data.statusString是20订单状态
data.expireTimeString是-过期时间(国家当地时间)
data.paymentLinkString是24支付链接
data.failMsgString否200订单失败原因
msgString否-异常信息
tidString是-traceId

响应示例

{
"code": 200,
"data": {
"merchantOrderNo": "CHECKOUT202609170001",
"tradeNo": "VS2608270002AR0000000000040059",
"transactionAmount": "100.00",
"status": "PAYING",
"expireTime": "2026-09-17 16:30:00",
"paymentLink": "https://test-ar-payin.vellpay.com/VS2609180004AR0000000000004065"
},
"msg": "success",
"tid": "747bbf80261844ed85b809212aab0d81"
}