出款
Developing
POST
/gateway/base/biz
用户付费提示
1.
2.
3.
4.
5.
| 错误码 | 错误描述 | 错误字段 |
|---|---|---|
| CUENTA Y NIT NO CORRESPONDEN | 账户所属人和上传身份信息不一致 | beneficiaryType或者beneficiaryId 错误 |
| CUENTA INACTIVA O BLOQUEADA | 不活跃账户或帐户被锁定 | beneficiaryAccountNumber或者beneficiaryBankCode或者beneficiaryBankType 错误 |
| NUMERO CUENTA INVALIDO | 帐号无效 | beneficiaryAccountNumber或者beneficiaryBankCode或者beneficiaryBankType 错误 |
| PAGO RECHAZADO EN ACH, CUENTA NO EXISTE | ACH拒绝付款，账户不存在 | beneficiaryAccountNumber 错误 |
| IDENTIFICACION NO COINCIDE CON CUENTA CLIENTE | 身份id与客户帐户不匹配 | beneficiaryType或者beneficiaryId 错误 |
| NUMERO CUENTA NO EXISTE | 账号不存在 | beneficiaryAccountNumber或者beneficiaryBankCode或者beneficiaryBankType 错误 |
| TIPO DE CUENTA NO VALIDO PARA BANCO DESTINO | 账户类型对目的地银行无效 | beneficiaryBankType 错误 |
Request
Header Params
Body Params application/json
Responses
Request Request Example
Shell
JavaScript
Java
Swift
cURL
curl --location --request POST 'http://prod-cn.your-api-server.com/gateway/base/biz' \
--header 'method: payOut' \
--header 'signType: SHA512' \
--header 'serviceName: api.pay' \
--header 'mchId: 1416010331032883200' \
--header 'timestamp: 1631671670' \
--header 'sign: 32554324534545432543' \
--header 'Content-Type: application/json' \
--data-raw '{
"mchOrderId": "21932322323358",
"amount": "5000.00",
"currency": "COP",
"purpose": "ONaJMGh",
"paymentType": "BRE_B",
"beneficiaryName": "TODAYPAY SAS",
"beneficiaryEmail": "todaypayco@gmail.com",
"beneficiaryMobile": "3214533051",
"beneficiaryAccountNumber": "3214533051",
"firstName": "TODAYPAY",
"beneficiaryAccountType": "SAVINGS",
"lastName": "SAS",
"docNumber": "9016938924",
"docType": "NIT",
"callbackUrl": "https://webhook.site/43f6f703-2f19-4b59-a8be-7c3f1475d50a"
}'Response Response Example
{
"data": [
{
"orderId": "string"
}
],
"resultCode": "string",
"errorCode": "string",
"errorMsg": "string"
}Modified at 2026-02-07 07:58:31