🇨🇴哥伦比亚

即时转账 - Transfiya

• payout_method.type = bank_transfer

• payout_method.payment_method = instant_transfer

payout_method_details 参数	类型	必填项	描述
first_name	String	是	收款人的名字。最多 50 个字符
last_name	String	是	收款人的姓氏。最多 50 个字符
phone_number	String	是	E164 格式 例如： +57XXXXXXXXXX
bank_code	String	是	“TRANSFIYA”

即时转账 Payload示例

请求示例

{
    "payout_method": {
        "type": "bank_transfer",
        "payment_method": "instant_transfer",
        "beneficiary": {
            "name": "John Doe",
            "payout_method_details": {
                "first_name": "John",
                "last_name": "Doe",
                "phone_number": "[phone]",
                "bank_code": "TRANSFIYA"
            }
        }
    },
    "amount": {
        "value": "2000.00",
        "currency_code": "COP"
    },
    "country_code": "CO",
    "purpose": "salaries",
    "reference": "Invoice #12345",
    "request_id": "unique_request_id"
}

响应示例

{
    "purpose": "SALARIES",
    "reference": "Invoice #12345",
    "id": "694e1f99-8924-4767-ade4-0db7c4e03f7a",
    "payout_method": {
        "type": "bank_transfer",
        "payment_method": "co_instant_transfer",
        "beneficiary_details": {
            "name": "John Doe"
        }
    },
    "amount": {
        "value": 2000.00,
        "currency_code": "COP"
    },
    "country_code": "CO",
    "request_id": "unique_request_id",
    "created_at": 1717576191
}

银行转账

• payout_method.type = bank_transfer

• payout_method.payment_method = bank_transfer

注意：支持电子钱包 – Dale、Nequi、Daviplate、Iirs、Movi、Rappipay。

可以在哥伦比亚银行代码部分找到。

payout_method_details 参数	类型	必填项	描述
first_name	String	是	收款人的名字。最多 50 个字符
last_name	String	是	收款人的姓氏。最多 50 个字符
phone_number	String	是	E164 格式 例如： +57XXXXXXXXXX
email	String	是	收款人的电子邮件。最多 100 个字符
address	String	是	收款人地址。最多 200 个字符
document_type	String	是	“NIT” - 税务识别号 (Número de Identificación Tributaria) “CC” - 公民身份证 (Cédula de Ciudadanía) “CE” - 外国人身份证 (Carnet Extranjeria) “PASS” - 护照 (Passport) “PEP” - 特别居留许可 (Permiso Especial de Permanencia)
document_id	String	是	请参阅下面的 “哥伦比亚文件 ID 验证”
account_number	String	是	请参阅下面的“哥伦比亚银行帐号验证”
account_type	String	是	“C”— 支票账户 “S”— 储蓄账户
bank_code	String	是	请参阅下面的“哥伦比亚银行代码”

银行转账Payload示例

请求示例

{
  "payout_method": {
    "type": "bank_transfer",
    "payment_method": "bank_transfer",
    "beneficiary": {
      "name": "John Doe",
      "payout_method_details": {
        "first_name": "John",
        "last_name": "Doe",
        "phone_number": "[phone]",
        "email": "[e-mail]",
        "address": "123 Main St, Bogotá, Colombia",
        "document_type": "CC",
        "document_id": "1004922993",
        "account_number": "123456789012",
        "account_type": "S",
        "bank_code": "059"
      }
    }
  },
  "amount": {
    "value": 2000.00,
    "currency_code": "COP"
  },
  "country_code": "CO",
  "purpose": "salaries",
  "reference": "Invoice #12345",
  "request_id": "unique_request_id"
}

响应示例

{
    "purpose": "SALARIES",
    "reference": "Invoice #12345",
    "id": "ff5b3a77-0e67-47a8-94f4-f2ac1865cd8b",
    "payout_method": {
        "type": "bank_transfer",
        "payment_method": "co_bank_transfer",
        "beneficiary_details": {
            "name": "John Doe"
        }
    },
    "amount": {
        "value": 2000,
        "currency_code": "COP"
    },
    "country_code": "CO",
    "request_id": "unique_request_id",
    "created_at": 1717576785
}

哥伦比亚文件 ID 验证

文件类型	长度	类型	验证数字	例子
CC	6 到 10 之间	Numeric	无	1.004.922.993 1004922993
NIT	10 或 11	Numeric	最后一位数字	901.458.652-7 901458.6527732000110
PASS	最多 12	Characters	无	-
CE	最多 12	Characters	无	-
PEP	15	Numeric	无	-

哥伦比亚银行帐号验证

对于每个银行账户，最小长度为3个数字。对于以下表格中没有最大长度的银行，最大长度为18。

某些银行要求账户号码字段具有特定结构：

银行	银行代码	储蓄 长度（最多）	活期 长度（最多）	储蓄账户 示例	支票账户 示例
Agrario	40	12	12	123456789012	123456789012
Av. Villas	52	11	13	12345678901	1234567890123
Banco de Bogota	1	11	11	12345678912	12345678912
Banco de Occidente	23	9	9	123456789	123456789
Bancolombia	7	11	11	27213213912	96382852354
Bancoomeva	61	12	12	123456789012	123456789012
BBVA	13	16	16（对于超过 15K 的payouts，我们只接受 9 位数的帐户）	1234570000000000	1234570000000000
Caja social BCSC	32	12	12	123456789012	123456789012
Confiar	292	9	9	123456789	123456789
Coopcentral S.A.	66	-	9	-	123456789
Cooperativa financiera de Antioquía	283	-	11	-	12345678901
Cotrafa cooperativa financiera	289	-	13	-	1234567890123
Davivienda	51	18	18	123456789012	123456789012
Falabella S.A.	62	12	12	123456789012	123456789012
Financiera Juriscoop	121	-	12	-	123456789012
Itau	14	9	9	123456789	123456789
Pichincha	60	9	9	123456789	123456789
Popular	2	9	9	620630925	645324752
Procredit	58	13	13	1234567890123	1234567890123
Santander	6	9	9	272132139	963828523
Scotiabank Colpatria	19	10	10	1234567890	1234567890
Sudameris	12	8	11	208342345908754	102938455738947

哥伦比亚银行代码

类型	银行名称	银行代码
银行转账（Transfiya）	Transfiya	TRA
银行转账和电子钱包	Bancamia S.A.	059
	Banco Agrario	040
	Banco Av. Villas	052
	Banco Caja Social BCSC	032
	Banco Credifinanciera S.A.	558
	Banco Dale	097
	Banco Davivienda	051
	Banco de Bogota	001
	Banco de Occidente	023
	Banco Falabella S.A.	062
	Banco Finandina S.A.	063
	Banco J.P. Morgan Colombia S.A.	71
	Banco Mundo Mujer	047
	Banco Pichincha	060
	Banco Popular	002
	Banco Procredit	058
	Banco Santander de Negocios Colombia S.A.	65
	Banco Serfinanza S.A.	069
	Banco Sudameris	012
	Banco W S.A.	053
	Bancoldex S.A.	031
	Bancolombia	007
	Bancoomeva	061
	BBVA	013
	Citibank	009
	Coltefinanciera S.A.	370
	Confiar	292
	Coofinep Cooperativa Financiera	291
	Coopcentral S.A.	066
	Cooperativa Financiera de Antioquia	283
	Corpbanca Itau	006
	Cotrafa Cooperativa Financiera	289
	Daviplata	551
	Financiera Juriscoop	121
	Giros y Finanzas CF	303
	Iris	637
	Itau	014
	LULO BANK S.A.	070
	MiBanco S.A.	067
	Movii	801
	Nequi	507
	Rappipay	151
	Scotiabank Colpatria	019