1. Webhook
Infinia API
  • Infinia E-commerce API
    • Introduction
    • API overview
    • Request and Response parameters
    • Encryption and Decryption
    • Account Binding
      • Account Binding
      • Account Binding Status Query
    • Trade Details
      • Trade details upload
      • Trade Details Upload Status Query
    • Query
      • Platform Account Balance Query
      • Seller's Available Revenue Share Query
      • Daily Revenue Sharing Download
    • Revenue Sharing
      • V2 FX Revenue Sharing
      • V2 FX Revenue Sharing Status Query
      • V1 Revenue Sharing
      • V1 Revenue Sharing Status Query
    • FX
      • Real-time rate
    • Webhook
      • Seller status notification
    • Appendix
      • System Code
      • Product types
      • CipherRsaUtil.java
      • Templates: Trade_details.csv
      • Templates: Trade_details_error_file.csv
      • Templates: Revenue _sharing_statement.csv
      • Log
    • Schemas
      • Schemas
        • ErrorBody
        • AccountBindingRequestData
        • AccountBindingResponseData
        • AccountBindingQueryRequestData
        • AccountBindingQueryResponseData
        • TradeDetailsUploadStatusRequestData
        • TradeDetailsUploadStatusResponseData
        • AccountBalanceQueryRequestData
        • AccountBalanceQueryResponseData
        • AvailableRevenueQueryRequestData
        • AvailableRevenueQueryResponseData
        • RevenueSharingRequestData
        • RevenueSharingResponseData
        • RevenueSharingStatusQueryRequestData
        • RevenueSharingStatusQueryResponseData
  • Infinia Payment API
    • Merchant
      • Merchant SignUp
      • Merchant Query
      • Merchant Webhook
    • Beneficiary
      • Beneficiary Create
      • Beneficiary Update
      • Beneficiary Query
      • Beneficiary Delete
      • Beneficiary Webhook
    • Payment
      • Payment Quote
      • Payment Fund
      • Payment Query
      • Payment Webhook
    • Account
      • Account Balance
  • Infinia 结汇付款 API
    • 客户实名认证
      • 客户实名认证
      • 客户实名认证状态查询
    • 结汇入账
      • 制单请求
    • 提现
      • 提现
    • 资金查询
      • 资金状态查询
    • 商户回调(示例路径)
      • 实名认证状态异步通知
      • 入账异步通知
      • 结汇成功/失败异步通知
      • 提现到账异步通知
    • Schemas
      • 统一加密请求公共字段
      • 统一加密响应公共字段
      • RSA 加密传输值
      • 实名认证申请请求报文
      • 实名认证申请响应报文
      • 实名认证状态查询请求报文
      • 实名认证状态查询响应报文
      • 制单请求报文
      • 制单响应报文
      • 提现请求报文
      • 提现响应报文
      • 资金状态查询请求报文
      • 资金状态查询响应报文
      • 实名认证状态回调请求报文
      • 入账状态回调请求报文
      • 结汇状态回调请求报文
      • 提现状态回调请求报文
      • 实名认证申请明文请求(中国大陆企业)
      • 日期或长期
      • 最终受益人
      • 实名认证申请明文响应
      • 实名认证状态查询明文请求
      • 实名认证状态查询明文响应
      • 实名认证状态回调明文请求
      • SFTP 交易明细 CSV 行
      • 制单明文请求
      • 制单明文响应
      • 入账状态回调明文请求
      • 结汇状态回调明文请求
      • 提现明文请求
      • 提现明文响应
      • 提现状态回调明文请求
      • 资金状态查询明文请求
      • 资金状态查询明文响应
  1. Webhook

Seller status notification


When a seller’s status changes (e.g., frozen / resumed), Infinia pushes a notification to the merchant-provided callback URL. The notification uses POST + JSON, and the payload is encrypted (payload). The merchant must decrypt it with the merchant’s private key (same logic as on the request side).

1. Endpoint & IO#

Callback URL: Provided by the merchant
Method: POST
Content-Type: application/json; charset=UTF-8
Response Contract:
On success, return the plain text SUCCESS (uppercase, no extra whitespace).
If the response is not SUCCESS or a network error occurs, the platform retries per the policy below.
Security note: The payload in the Webhook body is the Base64 of RSA-encrypted business JSON. The platform encrypts with the merchant public key, and the merchant decrypts with the merchant private key (same logic as “server uses client public key to encrypt; client uses private key to decrypt”).

2. Retry Policy#

If SUCCESS is not returned by the merchant endpoint, the platform retries (up to 5 times) at:
Immediately upon receiving the callback response
5 minutes later
15 minutes later
30 minutes later
60 minutes later
We recommend implementing idempotency using requestNo so duplicate deliveries do not cause duplicate processing.

3. Business JSON (After Decryption)#

3.1 Fields#

FieldTypeRequiredDescriptionExample
requestNostringyesUnique request/event ID (idempotency & trace)7042bac2-491b-41f8-b091-5199a20785c2
sellerIdstringyesSeller ID4347874
statusstring (enum)yesAccount statusFROZEN
status values:
ValueMeaning
ACTIVENormal
FROZENFrozen

3.2 Example (JSON)#

{'version":"1.0""appId":"infinia"dataType":"JSON""requestData""K2WZZ91WguhMOoc4e32aMIkrrw1+Z20StzMXC4+VkjGEW3779LfwntEr5nwrupouxytxv0xJ0zKNt70lRbVxajnr3hUDk/dSI/FCSN43WjEGtSglRe9mfX/5izcleedXWKjGEIZh9gA172a+Wy8LEszmMcM1I5o11ABmm9S75vpV6FvTduFUKPU6fxd8D0A/s+aDfKFUmoPiVv/IulIZxkxyNVDea5r8jzxUu1/l0rHZfom3jdKLGnHstifpn3rxqwNCsH9F7I8Ss4uh002kXnz1/SvJzbfYyTswZPKi+dmzS6i+LicPvEzaU+KclyutG5pgwei0cLkrcoYhiTjImplb39YD/wHwdIYvWeJGnKJjecfBxlyJusbGuXimXlRe8TaRsOmp03L2VVa6u9HP7I5F1MA9wvudKyTYG8k0XsqGxJay8cw/g5IMac906VfyoGQoanbqmORYwVuVsvuwHRjoF3hqy1zov00/JsxgCAdQeeTCNuDiX8if9cnL416rdFzXWRSXLX1TLvBnfXFTZwLcIGzItDnmOLgAeapcf7i6nVfgeqPJRiApldkbIOCNGgDxmfc1ThBcYsSuofnlmAKU0AoJGiP3VFitpv0ohivbtGtdnu5Gk+gV9kE8j8LWOwrPtyENBLa8Mf8zB75Ra81maS/CvSjAr4bKC2f5XBvjKo0pghsLk4dI4X3P9kYzJB/oLvEDhMz0SL3e2hV09k5puj+Dg68is60IVVyPG3SnmAE1Mg+ahPCmNMgOxZgTZG1QuA+7c2Mg6gx7g90Kzbz5+YaDMgk0q7pgE3JWOPXPJAuDbF2/WJx3AD15yh1IVE06A3e/Y3KjAFHZNMj99NFW2CR+2E0KNAk01JU33R5WdEfmndNo20kIxmmm/wTKDrewUghc1u68Z1l87a/YWYMFId0pcWxPnrcw8y5/yd/pM+1+9y40S0N0+0Idu2UrgC8qBo4H06CeEFETPJDsa5JyGAZ/Mvy6atpCA0Md6Fm5hKDwoTxs47L56M0VZ72B64ZHfdLhDX9CRMIN64D2VACq6LYR/AYbbbRjdELIRx4YWYC/ZZWgBSu4b+R8X3qzKAcz008RK3MBnz95xwT2u+1vlR9pR/pOHsf3jvzwCR84xkk/83ynucUaCilNgOiMkhcozjv3d0x4ie00WEAWXEWFTE0SJ9iF/Eyfo4YHHNCSIXMSoAPJmdNU480iNc/ZnCz/z0V+X3ygOmalAdNBTYveT1imwItuZwreJ/YjxCfFc3mLx0mJMkeWB4A3aTXDKOSYP4l00PBhELCTkg6uruIdMl6ONjbRcJG5ZEvKhYrLoJYSpk0QicGYHWWOCCEw+204GE0eD6UnAx+P5Pg==":"C38oSmZ7AkxDHmWBq3IgdfUORL4rGmp'signature'.HHlTq1XcjEuho81Cp/zlY+tXba2sGAVKtS82Yd7jCKgGWHM/kU6xfMa4g5nrBEn4cEHRt/kdP7ABICahGbkuqMUnWb2vp03KDdCAKfMSOTIsrmNVPHTmD08VU7IKijSFhrsI5780WGvflSRTNkoi0wgrYzFH6quaUnW6A0eBstkztke3zaP9fmWMu5sv2eDu4gMA496B5GLc4lq6jRrGPPPIn9p9XHJw06w0BT+8RxUa44t4wded0+pJU7qGnm20TlMav5PXiZcugteKP1VkhVw7Ja0u/9hNFWVSXD/VKHFUE/yOYB08Vy1bPLsjSRl3IM9z5MTcvkgsr6mgU4jTNhi+EjKZyiUU0g5WBUREt8t9gwwfXEhILfjnLIWTEIqVOalc8tSL+nd3k2r/wIrEdM6645oFib7u0hma4U3EzuTXYqqfpbjjIVNHddMp3pCutbe3+k/DYF73lT1NrHfk04jTcLv1xca+bRKxfDhD34dHGKjGtae8v0/2CASs+Nbii2g60H40A1KaU48i0B2YrTLDAWMSlntmFiFUV3CIPOOHLGOYAkOcmrBu896zmIgd3DCZ89pM/4SkkZ2CT3VPhDIZAkSHRz4MmO6fPRuGOXSyITInWGK7bZF11kMXmppXD+qsph+Mc="}
{
  "requestNo": "7042bac2-491b-41f8-b091-5199a20785c2",
  "sellerId": "4347874",
  "status": "FROZEN"
}

4. Consumer Response#

Success — return plain text SUCCESS:
Failure/Exception — any response other than SUCCESS (or a timeout) is treated as a failure; the platform retries per §3.
Modified at 2026-06-08 06:03:52
Previous
Real-time rate
Next
System Code
Built with