跳转到主要内容
POST
划转待处理资金
使用此端点在 VelaFi 系统内的两个商户账户之间划转法币资金。该划转为内部操作,无需银行交易。转出和转入商户都必须拥有与指定 fiat 和 paymentId 组合对应的有效账户。发起划转前,请先使用划转手续费端点查询适用的费用。
所有请求都必须包含 X-BH-TOKEN 请求头和 Content-Type: application/json。如果该 clientId 已被您账户下的任何资金记录(划转或提现)使用,请求将被拒绝并返回 -1174(Repeated submit request.),不会创建新的划转。

端点

POST https://api.velafi.com/v2/merchant/transfer

请求参数

string
您为此次划转设置的唯一标识符,用于去重和追踪。如果不提供,VelaFi 会自动生成。
number
必填
转出资金的商户 ID。
number
必填
接收资金的商户 ID。
string
必填
要划转的法币。支持的值:MXN、ARS、COP、BRL、PEN。
number
必填
与法币对应的支付渠道 ID:
  • 105 或 72 — MXN
  • 63 — ARS
  • 68 — COP
  • 90 — BRL
  • 95 — PEN
number
必填
以指定法币计价的划转金额。

响应字段

number
HTTP 风格的响应码。200 表示成功。
string
可读的状态消息,例如 SUCCESS。
object

示例

cURL
Response
使用 fromId 和 toId 值在资金记录端点中查找对应条目,以获取完整的审计轨迹。