金额最低5000COP 最大 3000000COP
paymentType 值为 NET_BANKING 时, 手机号格式为 +57xxxxxxxxx
当 paymentType 值为 TRANSFIYA 时, 用户必须开通了TRANSFIYA 服务 并且使用手机号做出款账户（beneficiaryAccountNumber）
用户需要先在银行应用程序中激活 Transfiya。
创建交易后，用户将收到一条短信，表明已通过 Transfiya 接受付款。如果用户没有收到消息，请直接在用户激活 Transfiya 的银行的应用程序中查看。
尽管每家银行都有自己的特定流程，但以下是大多数银行都遵循的一般分步指南：
2.
确保您已安装并更新了银行的移动应用程序, 登录银行应用程序
4.
寻找 Transfiya 选项, 此选项通常位于“转账”、“付款”或“特殊服务”部分
• 输入您的手机号码（必须是在银行注册的手机号码）。• 某些银行可能会要求您使用通过短信发送的代码确认链接。 | 错误码 | 错误描述 | 错误字段 |
|---|
| 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
Body Params application/json
{
"mchOrderId": "string",
"amount": "string",
"currency": "string",
"purpose": "string",
"beneficiaryName": "string",
"beneficiaryEmail": "string",
"beneficiaryMobile": "string",
"beneficiaryAccountNumber": "string",
"callbackUrl": "string",
"docType": "CC",
"docNumber": "string",
"beneficiaryBankName (取名称与值均可)": "001",
"beneficiaryAccountType": "CHECKING",
"paymentType": "TRANSFIYA"
}
Request Code Samples
curl --location '/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 '{
"mchOrderId": "string",
"amount": "string",
"currency": "string",
"purpose": "string",
"beneficiaryName": "string",
"beneficiaryEmail": "string",
"beneficiaryMobile": "string",
"beneficiaryAccountNumber": "string",
"callbackUrl": "string",
"docType": "CC",
"docNumber": "string",
"beneficiaryBankName (取名称与值均可)": "001",
"beneficiaryAccountType": "CHECKING",
"paymentType": "TRANSFIYA"
}'
Responses
application/json
{
"data": [
{
"orderId": "string"
}
],
"resultCode": "string",
"errorCode": "string",
"errorMsg": "string"
}
Modified at 2026-02-07 06:55:09
