跳转到主要内容
POST
主动收款(pull)

授权

Authorization
string
header
必填

会话 JWT(来自注册/登录)或 API key(pk_...)。 也接受 X-API-Key: <token> 作为替代请求头。

请求头

Idempotency-Key
string

idempotency_key 请求体字段的替代方式。

请求体

application/json
method
string
必填

收款方式(例如 c2p、debito_inmediato)。

amount
string
必填

本地金额,正数十进制字符串。

idempotency_key
string
必填

必填——collect 执行真实扣款;使用相同键的重试绝不重复扣款。

country
string
默认值:VE
currency
string
默认值:VES
description
string
our_reference
string
payer_document
string
payer_phone
string
payer_bank
string
payer_account
string
payer_name
string
payer_account_type
string
otp
string
otp_reference
string

响应

收款结果。paid: true 表示存款已入账。

payin_id
string
kind
string
country
string
currency
string
method
string
local_amount
string
status
string
fx_rate
string
usdt_gross
string
fee
string
usdt_credited
string
paid
boolean
provider_reference
string
status_code
string
status_message
string
failure
object

仅当主动收款的 payin 为 failed 时出现:拒绝来源(provider = 付款人的银行,core = 扣款前校验)以及具体的代码和消息。

最后修改于 2026年7月19日