{
  "payin_id": "4f8a1b2c-3d4e-5f60-7a8b-9c0d1e2f3a4b",
  "account_id": "9b1deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d",
  "country": "BO",
  "currency": "BOB",
  "local_amount": "700.00",
  "fx_rate": "6.91",
  "usdt_credited": "100.302460",
  "fee": "1.000000",
  "settlement_asset": "USDC",
  "conversion_status": "done",
  "instrument_id": "7e3f1b2c-4d5e-6f70-8a9b-0c1d2e3f4a5b",
  "instrument": {
    "instrument_id": "7e3f1b2c-4d5e-6f70-8a9b-0c1d2e3f4a5b",
    "account_number": "701458092378",
    "purpose": "fondeo",
    "status": "active"
  },
  "payer": {
    "name": "JUAN PEREZ",
    "document": "1234567",
    "account": "1000001"
  },
  "idempotency_key": "order-10042"
}

Payin 已入账

已收到一笔法币收款并入账到账户。对于通用收款链接(kind: checkout),载荷还携带 settled_via(如 qr、crypto:tron:usdt、cbpay)、settlement_asset 与 asset_amount;加密货币支付附加 crypto_amount,CBPay 应用支付附加 transfer_id、asset 与 amount。当账户配置了不同于入账资产的 default_payin_asset 时,载荷还携带入账后自动兑换的 settlement_asset 与 conversion_status。

每次投递均包含 X-Webhook-Event、X-Webhook-Event-ID、X-Webhook-Delivery-ID、X-Webhook-Timestamp 和 X-Webhook-Signature = hex(HMAC-SHA256(secret, timestamp + "." + body))。请返回 2xx;最多重试 5 次,间隔递增。

WEBHOOK

payin_credited

{
  "payin_id": "4f8a1b2c-3d4e-5f60-7a8b-9c0d1e2f3a4b",
  "account_id": "9b1deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d",
  "country": "BO",
  "currency": "BOB",
  "local_amount": "700.00",
  "fx_rate": "6.91",
  "usdt_credited": "100.302460",
  "fee": "1.000000",
  "settlement_asset": "USDC",
  "conversion_status": "done",
  "instrument_id": "7e3f1b2c-4d5e-6f70-8a9b-0c1d2e3f4a5b",
  "instrument": {
    "instrument_id": "7e3f1b2c-4d5e-6f70-8a9b-0c1d2e3f4a5b",
    "account_number": "701458092378",
    "purpose": "fondeo",
    "status": "active"
  },
  "payer": {
    "name": "JUAN PEREZ",
    "document": "1234567",
    "account": "1000001"
  },
  "idempotency_key": "order-10042"
}

授权

Authorization

string

header

必填

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

请求体

application/json

payin_id

string

account_id

string

country

string

currency

string

local_amount

string

fx_rate

string

usdt_credited

string

fee

string

settlement_asset

string

conversion_status

string

instrument_id

string<uuid>

收到 payin 的专用收款工具；不适用时省略。

instrument

object

收到该 payin 的专用收款工具。通用收款和历史 payin 不返回此对象。

Show child attributes

payer

object

银行在新入账 push 中报告的付款人身份（有数据时返回）。

Show child attributes

idempotency_key

string

响应

200

返回任意 2xx 以确认投递。