出款 - API Bkpays Doc

金额不支持小数

金额最低5000COP 最大 3000000COP

paymentType 值为 NET_BANKING 时, 手机号格式为 +57xxxxxxxxx

当 paymentType 值为 TRANSFIYA 时, 用户必须开通了TRANSFIYA 服务并且使用手机号做出款账户（beneficiaryAccountNumber）

用户付费提示

用户需要先在银行应用程序中激活 Transfiya。

创建交易后，用户将收到一条短信，表明已通过 Transfiya 接受付款。如果用户没有收到消息，请直接在用户激活 Transfiya 的银行的应用程序中查看。

如何在哥伦比亚激活 Transfiya

尽管每家银行都有自己的特定流程，但以下是大多数银行都遵循的一般分步指南：

下载或更新您银行的应用程序

确保您已安装并更新了银行的移动应用程序, 登录银行应用程序

使用您的凭证（用户名和密码）访问应用程序。

寻找 Transfiya 选项, 此选项通常位于“转账”、“付款”或“特殊服务”部分

关联您的手机号码

• 选择注册或激活 Transfiya 的选项。

• 输入您的手机号码（必须是在银行注册的手机号码）。

• 某些银行可能会要求您使用通过短信发送的代码确认链接。

如何通过 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

Header Params

Body Params application/json

Example

{
    "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

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

出款

Request

Request Code Samples

Responses