获取支付方式模板

GET

payments

templates

获取支付方式模板

curl --request GET \
  --url https://api-test.velafi.com/v2/payments/templates \
  --header 'X-BH-TOKEN: <api-key>'

const options = {method: 'GET', headers: {'X-BH-TOKEN': '<api-key>'}};

fetch('https://api-test.velafi.com/v2/payments/templates', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "code": 123,
  "msg": "<string>",
  "data": {}
}

添加收款人之前，请调用此接口以确切了解某个支付方式需要哪些字段。传入数字 paymentId 后，API 会返回一个对象，其键直接对应你在创建收款人时要提交的 fieldJson。不同地区的模板差异很大 —— 墨西哥 SPEI 付款需要 CLABE 和账户类型，阿根廷 CVU 付款需要 CVU/CBU 号码和 CUIT，而 SEPA 转账则需要 IBAN 格式的账号以及账户持有人信息。

接口地址

GET https://api.velafi.com/v2/payments/templates

在沙盒环境中测试时，请使用 https://api-test.velafi.com/v2/payments/templates。

请求参数

integer

必填

支付方式的数字 ID。所有支持的取值请参见下方的支付方式 ID 表。

支付方式 ID

下表列出了所有支持的支付方式。请将 Payment ID 列的值用作 paymentId 查询参数。

Payment ID	名称	类型	通道
105	SPEI (Finco Pay)	自动	CLABE – FINCO PAY
72	SPEI (Tesored)	自动	CLABE – TESORED
63 (sandbox: 18)	CBU/CVU (Momentum)	自动	CVU – Momentum
137	3.0 Transfer (QR)	自动	QR Argentina
81 (sandbox: 532)	ACH Reference – Lead Bank	自动	Lead Bank
82 (sandbox: 533)	ACH Virtual – Lead Bank	自动	Lead Bank
83 (sandbox: 534)	FedWire Reference – Lead Bank	自动	Lead Bank
84 (sandbox: 535)	FedWire Virtual – Lead Bank	自动	Lead Bank
85	SEPA (Bridge)	自动	Lead Bank
90	Pix (Genial)	自动	BANCO GENIAL
92	Pix – Woovi	自动	Avenia
95	银行转账	自动	PEN 账户
120	Wire (CPN)，仅限付款	自动	Circle Payment Network
122	FPS (CPN)，仅限付款	自动	Circle Payment Network
123	CHATS (CPN)，仅限付款	自动	Circle Payment Network
124	SEPA (CPN)，仅限付款	自动	Circle Payment Network
125	BANK-TRANSFER (CPN)，仅限付款	自动	Circle Payment Network
127	FEDWIRE (CPN)，仅限付款	自动	Circle Payment Network
106	Wire (HK Trade Payouts)，仅限付款	自动	—
68	Automatic ACH	自动	COP 账户
69	Bre-B	自动	COP 账户
141	PSE，仅限收款	自动	COP 账户
142	BanColombia，仅限收款	自动	COP 账户
143	Nequi，仅限收款	自动	COP 账户
144	QR Bre-B，仅限收款	自动	COP 账户
70	VelaFi Pending Fund	自动	—
27	银行转账（巴西）	手动	—
28	银行转账（阿根廷）	手动	—
48	银行转账（哥伦比亚）	手动	—
56	Manual ACH/WIRE	手动	—
59	Manual ACH – Perú	手动	—
60	银行转账（智利）	手动	—
61	Manual USD Payments (CHATS)	手动	—
62	Bridge	手动	—
89	SEPA	手动	—
103	SEPA	手动	—
500	银行转账（玻利维亚，手动）	手动	—
501	WIRE (HK TRADE PAYIN)	手动	—
503	Manual CNY Payout	手动	—
504	Manual Global USD Payout	手动	—
505	TED	手动	—

响应字段

integer

响应状态码。200 表示成功。

string

可读的响应信息，例如 "SUCCESS"。

object

必填模板字段的键值映射。键为字段名；值为空字符串，表示添加收款人时需要填写的内容。

请求与响应示例

curl -X GET "https://api.velafi.com/v2/payments/templates?paymentId=105" \
  -H "X-BH-TOKEN: YOUR_TOKEN"

{
  "code": 200,
  "msg": "SUCCESS",
  "data": {
    "Account Type": "",
    "Account Number": "",
    "Beneficiary Name": "",
    "Bank Code": ""
  }
}

Account Type 必须为 clabe（虚拟账户）或 debit（银行卡账户）。仅当 Account Type 为 debit 时才需要 Bank Code。请参见下方的墨西哥 FINCO PAY 银行代码部分。

curl -X GET "https://api.velafi.com/v2/payments/templates?paymentId=72" \
  -H "X-BH-TOKEN: YOUR_TOKEN"

{
  "code": 200,
  "msg": "SUCCESS",
  "data": {
    "Account Type": "",
    "Full Name": "",
    "Bank Code": "",
    "Bank Account Number": ""
  }
}

Account Type 必须为 clabe 或 spei_card。仅当 Account Type 为 spei_card 时才需要 Bank Code。请参见下方的墨西哥 TESORED 银行代码部分。

curl -X GET "https://api.velafi.com/v2/payments/templates?paymentId=63" \
  -H "X-BH-TOKEN: YOUR_TOKEN"

{
  "code": 200,
  "msg": "SUCCESS",
  "data": {
    "CVU/CBU Number": "",
    "cuit": "",
    "Bank name": ""
  }
}

curl -X GET "https://api.velafi.com/v2/payments/templates?paymentId=137" \
  -H "X-BH-TOKEN: YOUR_TOKEN"

{
  "code": 200,
  "msg": "SUCCESS",
  "data": {
    "cuit": "",
    "cvu/cbu": ""
  }
}

curl -X GET "https://api.velafi.com/v2/payments/templates?paymentId=85" \
  -H "X-BH-TOKEN: YOUR_TOKEN"

{
  "code": 200,
  "msg": "SUCCESS",
  "data": {
    "Bank Name": "",
    "Account Owner Name": "",
    "Account Owner Type": "",
    "Bank Country/Region": "",
    "Account Number": "",
    "Bic": "",
    "firstName": "",
    "lastName": "",
    "businessName": ""
  }
}

Account Owner Type 必须为 Business 或 Individual。若为 Business，请提供 businessName；若为 Individual，请同时提供 firstName 和 lastName。Bank Country/Region 使用 ISO 3166-1 代码。

curl -X GET "https://api.velafi.com/v2/payments/templates?paymentId=81" \
  -H "X-BH-TOKEN: YOUR_TOKEN"

{
  "code": 200,
  "msg": "SUCCESS",
  "data": {
    "Bank Name": "",
    "Account Owner Name": "",
    "Account Owner Type": "",
    "Bank Country/Region": "",
    "Account Number": "",
    "Routing Number": "",
    "Street Line1": "",
    "Street Line2": "",
    "City": "",
    "State": "",
    "Postal Code": "",
    "firstName": "",
    "lastName": "",
    "businessName": ""
  }
}

Bank Country/Region 使用 ISO 3166-1 代码。State 使用 ISO 3166-2 代码（例如 US-CA）。

curl -X GET "https://api.velafi.com/v2/payments/templates?paymentId=68" \
  -H "X-BH-TOKEN: YOUR_TOKEN"

{
  "code": 200,
  "msg": "SUCCESS",
  "data": {
    "Account Type": "",
    "Full Name": "",
    "ID Document Type": "",
    "ID Document Number": "",
    "Bank Code": "",
    "Bank Account Number": ""
  }
}

Account Type 枚举值：cc（支票账户）、ch（储蓄账户）、dp（电子存款）。ID Document Type 枚举值：cc、nit、ce、pa、ppt、ti、rc、te、die、nd。请参见下方的哥伦比亚银行代码。

curl -X GET "https://api.velafi.com/v2/payments/templates?paymentId=90" \
  -H "X-BH-TOKEN: YOUR_TOKEN"

{
  "code": 200,
  "msg": "SUCCESS",
  "data": {
    "Pix Type": "",
    "Pix Key": ""
  }
}

Pix Type 枚举值：CPF（11 位数字）、CNPJ（14 位数字）、EMAIL、PHONE（10–11 位数字）、RANDOM_KEY（包含 -）。

curl -X GET "https://api.velafi.com/v2/payments/templates?paymentId=120" \
  -H "X-BH-TOKEN: YOUR_TOKEN"

{
  "code": 200,
  "msg": "SUCCESS",
  "data": {
    "beneficiaryName": "",
    "country": "",
    "stateProvince": "",
    "city": "",
    "street": "",
    "postalCode": "",
    "dateOfBirth": "",
    "idNumber": "",
    "idExpirationDate": "",
    "useCase": "",
    "reasonForPayment": "",
    "bankName": "",
    "bankCountry": "",
    "swiftCode": "",
    "accountNumber": ""
  }
}

各支付方式的收款人字段

下表列出每个已启用付款方式定义的 fieldJson 键，取自支付方式模板。运行时请以本接口返回的内容为准。

键：发送键列中的字段标题。如果字段还有 indexCode，也可以改用 indexCode 作为键。
账户持有人类型（Business 或 Individual）： 为 Business 时，还需发送 businessName；为 Individual 时，还需发送 firstName 和 lastName（两者至少填写一个）。
下拉字段： 发送本接口为该字段返回的某个选项的 code。其他值会被拒绝并返回 -4010。
必填字段： 缺少必填字段的请求会被拒绝并返回 -4010。
支付方式 62、89 和 103 未定义 fieldJson 字段。

Mexico — SPEI (Finco Pay) (105)

键	`indexCode`	必填	取值
`Account Type`	—	必填	下拉选项：选项的 `code`
`Account Number`	—	必填	数字
`Beneficiary Name`	—	必填	文本
`Bank Code`	—	可选	下拉选项：选项的 `code`

Mexico — SPEI (Tesored) (72)

键	`indexCode`	必填	取值
`Account Type`	`accountType`	必填	下拉选项：选项的 `code`
`Full Name`	`fullName`	必填	文本
`Bank Code`	`bankCode`	可选	下拉选项：选项的 `code`
`Bank Account Number`	`bankAccountNumber`	必填	字母和数字

Argentina — CBU/CVU (Momentum) (63)

键	`indexCode`	必填	取值
`Account Number`	`accountNumber`	必填	文本
`CUIT`	`cuit`	必填	文本
`Account Type`	`accountType`	必填	下拉选项：选项的 `code`

Argentina — 3.0 Transfer (QR) (137)

键	`indexCode`	必填	取值
`cvu/cbu`	`cvu`	必填	文本
`cuit`	`cuit`	必填	文本

Brazil — Pix (Genial) (90)

键	`indexCode`	必填	取值
`Pix Type`	—	必填	下拉选项：选项的 `code`
`Pix Key`	—	必填	文本

Brazil — Pix - Woovi (Avenia) (92)

键	`indexCode`	必填	取值
`Pix Type`	`pixType`	必填	下拉选项：选项的 `code`
`Pix Key`	`pixKey`	必填	文本

Colombia — Automatic ACH (68)

键	`indexCode`	必填	取值
`Account Type`	—	必填	下拉选项：选项的 `code`
`Full Name`	—	必填	文本
`ID Document Type`	—	必填	下拉选项：选项的 `code`
`ID Document Number`	—	必填	字母和数字
`Bank Code`	—	必填	下拉选项：选项的 `code`
`Bank Account Number`	—	必填	字母和数字

Colombia — Bre-B (69)

键	`indexCode`	必填	取值
`Breb Key`	`brebKey`	必填	文本
`Email`	`email`	可选	文本
`Phone Number`	`phone`	可选	文本

Peru — Bank Transfer (95)

键	`indexCode`	必填	取值
`Bank Name`	—	必填	下拉选项：选项的 `code`
`Account Type`	—	必填	下拉选项：选项的 `code`
`Account Number`	—	必填	数字
`CCI Number`	—	可选	数字
`Email`	—	必填	文本
`Identification Type`	—	必填	下拉选项：选项的 `code`
`Identification Number`	—	必填	数字
`Name`	—	必填	文本
`Phone Number`	—	必填	数字

United States — ACH / FedWire (Lead Bank) (81, 82, 83, 84)

键	`indexCode`	必填	取值
`Bank Name`	—	必填	文本
`Account Owner Name`	—	必填	文本
`Account Owner Type`	—	必填	`Business` 或 `Individual`
`Bank Country/Region`	—	必填	国家，ISO 3166-1 两位代码（如 `US`）
`Account Number`	—	必填	字母和数字
`Routing Number`	—	必填	文本
`Street Line1`	—	必填	文本
`Street Line2`	—	可选	文本
`City`	—	必填	文本
`State`	—	必填	地区，ISO 3166-2（如 `US-CA`）
`Postal Code`	—	必填	文本

Europe — SEPA (Bridge) (85)

键	`indexCode`	必填	取值
`Bank Name`	—	必填	文本
`Account Owner Name`	—	必填	文本
`Account Owner Type`	—	必填	`Business` 或 `Individual`
`Bank Country/Region`	—	必填	国家，ISO 3166-1 两位代码（如 `US`）
`Account Number`	—	必填	字母和数字
`Bic`	—	必填	文本

Circle Payment Network — Wire (120)

键	`indexCode`	必填	取值
`Beneficiary Name`	`beneficiaryName`	必填	文本
`Nationality`	`country`	必填	国家，ISO 3166-1 两位代码（如 `US`）
`Country of Residence`	`stateProvince`	必填	地区，ISO 3166-2（如 `US-CA`）
`City`	`city`	必填	文本
`Street`	`street`	必填	文本
`Postal Code`	`postalCode`	必填	文本
`Date of Birth / Date of Incorporation`	`dateOfBirth`	可选	日期，`yyyy-MM-dd`
`ID Number / Tax ID`	`idNumber`	可选	文本
`ID Expiration Date`	`idExpirationDate`	可选	日期，`yyyy-MM-dd`
`Use Case`	`useCase`	必填	下拉选项：选项的 `code`
`Reason For Payment`	`reasonForPayment`	必填	下拉选项：选项的 `code`
`Bank Name`	`bankName`	必填	文本
`Bank Country`	`bankCountry`	必填	国家，ISO 3166-1 两位代码（如 `US`）
`SWIFT Code`	`swiftCode`	必填	文本
`Account Number`	`accountNumber`	必填	字母和数字

Circle Payment Network — FPS (122)

键	`indexCode`	必填	取值
`Beneficiary Name`	`beneficiaryName`	必填	文本
`Nationality`	`country`	必填	国家，ISO 3166-1 两位代码（如 `US`）
`Country of Residence`	`stateProvince`	必填	地区，ISO 3166-2（如 `US-CA`）
`City`	`city`	必填	文本
`Street`	`street`	必填	文本
`Postal Code`	`postalCode`	必填	文本
`Date of Birth / Date of Incorporation`	`dateOfBirth`	可选	日期，`yyyy-MM-dd`
`ID Number / Tax ID`	`idNumber`	可选	文本
`ID Expiration Date`	`idExpirationDate`	可选	日期，`yyyy-MM-dd`
`Use Case`	`useCase`	必填	下拉选项：选项的 `code`
`Reason For Payment`	`reasonForPayment`	必填	下拉选项：选项的 `code`
`Recipient Email`	`recipientEmail`	必填	文本
`Recipient Phone Number`	`recipientPhoneNumber`	必填	国际电话区号
`FPS ID`	`fpsId`	必填	文本
`Bank Code`	`bankCode`	必填	文本
`Account Number`	`accountNumber`	必填	字母和数字

Circle Payment Network — CHATS (123)

键	`indexCode`	必填	取值
`Beneficiary Name`	`beneficiaryName`	必填	文本
`Nationality`	`country`	必填	国家，ISO 3166-1 两位代码（如 `US`）
`Country of Residence`	`stateProvince`	必填	地区，ISO 3166-2（如 `US-CA`）
`City`	`city`	必填	文本
`Street`	`street`	必填	文本
`Postal Code`	`postalCode`	必填	文本
`Date of Birth / Date of Incorporation`	`dateOfBirth`	可选	日期，`yyyy-MM-dd`
`ID Number / Tax ID`	`idNumber`	可选	文本
`ID Expiration Date`	`idExpirationDate`	可选	日期，`yyyy-MM-dd`
`Use Case`	`useCase`	必填	下拉选项：选项的 `code`
`Reason For Payment`	`reasonForPayment`	必填	下拉选项：选项的 `code`
`Bank Code`	`bankCode`	必填	文本
`Bank Name`	`bankName`	必填	文本
`SWIFT Code`	`swiftCode`	必填	文本
`Account Number`	`accountNumber`	必填	字母和数字
`Recipient City`	`recipientCity`	必填	文本
`Recipient Address Street`	`recipientAddressStreet`	必填	文本
`Recipient Address City`	`recipientAddressCity`	必填	文本
`Recipient Address Country`	`recipientAddressCountry`	必填	国家，ISO 3166-1 两位代码（如 `US`）
`Recipient Address State Province`	`recipientAddressStateProvince`	必填	地区，ISO 3166-2（如 `US-CA`）
`Recipient Address Postal Code`	`recipientAddressPostalCode`	必填	文本

Circle Payment Network — SEPA (124)

键	`indexCode`	必填	取值
`Beneficiary Name`	`beneficiaryName`	必填	文本
`Nationality`	`country`	必填	国家，ISO 3166-1 两位代码（如 `US`）
`Country of Residence`	`stateProvince`	必填	地区，ISO 3166-2（如 `US-CA`）
`City`	`city`	必填	文本
`Street`	`street`	必填	文本
`Postal Code`	`postalCode`	必填	文本
`Date of Birth / Date of Incorporation`	`dateOfBirth`	可选	日期，`yyyy-MM-dd`
`ID Number / Tax ID`	`idNumber`	可选	文本
`ID Expiration Date`	`idExpirationDate`	可选	日期，`yyyy-MM-dd`
`Use Case`	`useCase`	必填	下拉选项：选项的 `code`
`Reason For Payment`	`reasonForPayment`	必填	下拉选项：选项的 `code`
`Bank Name`	`bankName`	必填	文本
`Bank Country`	`bankCountry`	必填	国家，ISO 3166-1 两位代码（如 `US`）
`SWIFT Code`	`swiftCode`	必填	文本
`IBAN`	`accountNumber`	必填	文本

Circle Payment Network — Bank Transfer (125)

键	`indexCode`	必填	取值
`Beneficiary Name`	`beneficiaryName`	必填	文本
`Nationality`	`country`	必填	国家，ISO 3166-1 两位代码（如 `US`）
`Country of Residence`	`stateProvince`	必填	地区，ISO 3166-2（如 `US-CA`）
`City`	`city`	必填	文本
`Street`	`street`	必填	文本
`Postal Code`	`postalCode`	必填	文本
`Date of Birth / Date of Incorporation`	`dateOfBirth`	可选	日期，`yyyy-MM-dd`
`ID Number / Tax ID`	`idNumber`	可选	文本
`ID Expiration Date`	`idExpirationDate`	可选	日期，`yyyy-MM-dd`
`Use Case`	`useCase`	必填	下拉选项：选项的 `code`
`Reason For Payment`	`reasonForPayment`	必填	下拉选项：选项的 `code`
`Bank Name`	`bankName`	必填	文本
`Bank Country`	`bankCountry`	必填	国家，ISO 3166-1 两位代码（如 `US`）
`SWIFT Code`	`swiftCode`	必填	文本
`Account Number`	`accountNumber`	必填	字母和数字

Circle Payment Network — FEDWIRE (127)

键	`indexCode`	必填	取值
`Beneficiary Name`	`beneficiaryName`	必填	文本
`Nationality`	`country`	必填	国家，ISO 3166-1 两位代码（如 `US`）
`Country of Residence`	`stateProvince`	必填	地区，ISO 3166-2（如 `US-CA`）
`City`	`city`	必填	文本
`Street`	`street`	必填	文本
`Postal Code`	`postalCode`	必填	文本
`Date of Birth / Date of Incorporation`	`dateOfBirth`	可选	日期，`yyyy-MM-dd`
`ID Number / Tax ID`	`idNumber`	可选	文本
`ID Expiration Date`	`idExpirationDate`	可选	日期，`yyyy-MM-dd`
`Use Case`	`useCase`	必填	下拉选项：选项的 `code`
`Reason For Payment`	`reasonForPayment`	必填	下拉选项：选项的 `code`
`Bank Name`	`bankName`	必填	文本
`Bank Country`	`bankCountry`	必填	国家，ISO 3166-1 两位代码（如 `US`）
`Account Number`	`accountNumber`	必填	字母和数字
`Routing Number`	`routingNumber`	必填	文本
`Recipient City`	`recipientCity`	必填	文本
`Recipient Address Street`	`recipientAddressStreet`	必填	文本
`Recipient Address City`	`recipientAddressCity`	必填	文本
`Recipient Address Country`	`recipientAddressCountry`	必填	国家，ISO 3166-1 两位代码（如 `US`）
`Recipient Address State Province`	`recipientAddressStateProvince`	必填	地区，ISO 3166-2（如 `US-CA`）
`Recipient Address Postal Code`	`recipientAddressPostalCode`	必填	文本

Hong Kong — Wire (HK Trade Payouts) (106)

键	`indexCode`	必填	取值
`Beneficiary Email`	—	必填	文本
`Supporting Documents`	—	必填	图片：Upload File 返回的 `fileUrl`（多个用逗号分隔）
`Beneficiary Name`	—	必填	文本
`Account Number`	—	必填	文本
`Bank Name`	—	必填	文本
`Swift Code`	—	必填	文本

人工 — Bank Transfer (Brazil) (27)

键	`indexCode`	必填	取值
`Bank name`	—	必填	文本
`Bank code`	—	必填	文本
`Branch code`	—	必填	文本
`Account number`	—	必填	文本
`CPF/CNPJ`	—	必填	文本

人工 — Bank Transfer (Argentina) (28)

键	`indexCode`	必填	取值
`Account number`	—	必填	文本
`CBU`	—	必填	数字
`CUIT/CUIL`	—	必填	文本
`Email`	—	可选	文本
`ID`	—	必填	文本

人工 — Bank Transfer (Colombia) (48)

键	`indexCode`	必填	取值
`Número de cuenta`	—	必填	数字
`Número de identificación`	—	必填	字母和数字
`Tipo de cuenta`	—	必填	文本
`Banco`	—	必填	文本

人工 — ACH/WIRE (56)

键	`indexCode`	必填	取值
`Account Details`	—	必填	文本

人工 — ACH (Perú) (59)

键	`indexCode`	必填	取值
`Cuenta`	—	必填	文本
`Tipo`	—	必填	字母
`CCI`	—	必填	文本
`Banco`	—	必填	字母
`Moneda`	—	必填	字母
`RUC`	—	必填	文本
`Real Name`	—	必填	字母

人工 — Bank Transfer (Chile) (60)

键	`indexCode`	必填	取值
`Bank name`	—	必填	文本
`RUT`	—	必填	文本
`Account type`	—	必填	文本
`Account number`	—	必填	文本

人工 — USD Payments (CHATS) (61)

键	`indexCode`	必填	取值
`Account Number`	—	必填	文本
`Bank Name`	—	必填	文本
`SWIFT CODE`	—	可选	文本
`Address`	—	可选	文本
`Beneficiary Name`	—	必填	文本
`Beneficiary Tax ID or Registration ID`	—	必填	文本

人工 — Bank Transfer (Bolivia) (500)

键	`indexCode`	必填	取值
`Banco`	—	可选	字母
`Cuenta`	—	必填	数字
`NIT`	—	必填	数字
`Nombre`	—	必填	文本
`QR`	—	可选	图片：Upload File 返回的 `fileUrl`（多个用逗号分隔）

人工 — WIRE (HK Trade Pay-in) (501)

键	`indexCode`	必填	取值
`Beneficiary Name`	—	必填	文本
`Account Number`	—	必填	数字
`Beneficiary Address`	—	必填	文本
`SWIFT CODE`	—	必填	文本
`Bank Name`	—	必填	文本
`Bank Code`	—	必填	文本
`Bank Address`	—	必填	文本

人工 — CNY Payout (503)

键	`indexCode`	必填	取值
`Beneficiary Business Legal Name`	—	必填	文本
`Beneficiary Business Organization ID Number`	—	必填	文本
`Beneficiary Business Name in Chinese Hanzi characters`	—	必填	文本
`Beneficiary Address`	—	必填	文本
`Beneficiary Account Number`	—	必填	文本
`Beneficiary Bank and Branch Info`	—	必填	文本

人工 — Global USD Payout (504)

键	`indexCode`	必填	取值
`Beneficiary Name`	—	必填	文本
`Account Number`	—	必填	文本
`Beneficiary Address`	—	必填	文本
`SWIFT CODE`	—	必填	文本
`Bank Name`	—	必填	文本
`Bank Code`	—	可选	数字
`Bank Address`	—	必填	文本
`Bank Country`	—	必填	国家，ISO 3166-1 两位代码（如 `US`）

人工 — TED (Brazil) (505)

键	`indexCode`	必填	取值
`Nome Favorecido`	—	必填	字母
`Banco/Instituição`	—	必填	字母
`" Nº Banco/ISPB"` (starts with a space)	—	必填	数字
`Dados da Conta`	—	必填	文本

参考：银行代码表

代码	银行	账户类型
1001	BANCO DE BOGOTA	cc, ch, dp
1002	BANCO POPULAR	cc, ch, dp
1006	ITAU	cc, ch
1007	BANCOLOMBIA	cc, ch, dp
1009	CITIBANK	cc, ch
1012	BANCO GNB SUDAMERIS	cc, ch
1013	BBVA COLOMBIA	cc, ch, dp
1019	SCOTIABANK COLPATRIA S.A	cc, ch
1023	BANCO DE OCCIDENTE	cc, ch
1032	BANCO CAJA SOCIAL BCSC SA	cc, ch
1040	BANCO AGRARIO	cc, ch, dp
1051	BANCO DAVIVIENDA SA	cc, ch, dp
1052	BANCO AV VILLAS	cc, ch, dp
1061	BANCOOMEVA	cc, ch, dp
1066	BANCO COOPERATIVO COOPCENTRAL	cc, ch, dp
1067	MIBANCO S.A.	cc, ch, dp
1070	LULO BANK S.A.	ch
1097	Dale	dp
1507	NEQUI	ch, dp
1551	DAVIPLATA	dp
1558	BAN100 S.A	cc, ch
1801	MOVII	dp
1809	NU COLOMBIA	ch
1811	RAPPIPAY	ch, dp

秘鲁银行代码

代码	银行
002	Banco de Crédito del Perú
003	Interbank
009	Scotiabank Perú S.A.A.
011	BBVA Continental Perú
018	Banco de la Nación
023	Banco de Comercio
035	Banco Pichincha
049	Mi Banco
053	Banco GNB Perú
055	Banco Ripley
056	Banco Santander Perú
060	ICBC Perú Bank
802	CMAC Trujillo
803	CMAC Arequipa
805	CMAC Sullana
808	CMAC Huancayo
921	LIGO

墨西哥 FINCO PAY 银行代码（部分）

代码	银行
cc1cdae0-3091-40b7-80af-681fdf6a9bfd	BANAMEX
e4e7f75c-4f61-4bce-b411-a5509347d755	BBVA BANCOMER
0997b675-5230-4752-ae14-cff991d9f6c3	SANTANDER
89bfe0b7-ccd2-4f2d-93ef-472a62a1da45	HSBC
ec7f37e2-4a5d-4df7-9a0d-17200497a603	BANORTE
9ded667d-ad5c-4da8-aa85-acf56a14adb7	NU_MEXICO
84e4e446-f7ed-4551-9360-ad39e5a2bf06	KLAR
5d4208e6-8c5b-4654-a98a-5e35fef74c2b	MERCADO_PAGO_W

墨西哥 TESORED 银行代码（部分）

代码	银行
40002	Banamex
40012	BBVA Mexico
40014	Santander
40021	HSBC
40072	Banorte
90638	Nu Mexico
90722	Mercado Pago
90734	FINCO PAY

⌘I

获取支付方式模板

curl --request GET \
  --url https://api-test.velafi.com/v2/payments/templates \
  --header 'X-BH-TOKEN: <api-key>'

const options = {method: 'GET', headers: {'X-BH-TOKEN': '<api-key>'}};

fetch('https://api-test.velafi.com/v2/payments/templates', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "code": 123,
  "msg": "<string>",
  "data": {}
}

概览

账户

配置

商户

加密钱包

收款人

报价

订单

Webhooks

获取支付方式模板

接口地址

请求参数

支付方式 ID

响应字段

请求与响应示例

各支付方式的收款人字段

参考：银行代码表

​接口地址

​请求参数

​支付方式 ID

​响应字段

​请求与响应示例

​各支付方式的收款人字段

​参考：银行代码表

接口地址

请求参数

支付方式 ID

响应字段

请求与响应示例

各支付方式的收款人字段

参考：银行代码表