- Get started
- Guides
- Virtual Account
- Wallet
- Convert
- API Reference
- Virtual Account
- Virtual Account field notes
- Inquiry Master VA Balance
- List Primary Virtual Accounts
- Create Virtual Account
- Get Virtual Account Detail
- List Virtual Account
- List Virtual Account Orders
- Get Virtual Account Order Detail
- Refund Virtual Account Order
- List RFI Sub Virtual Account
- Get Sub Virtual Account RFI Template Info
- Sub Virtual Account Submit RFI
- Add Bank Account
- List Bank Account
- List Banks
- Payout via Virtual Account
- Send Email Verify Code
- Wallet
- Wallet field notes
- Deposit Whitelist
- Get Deposit Whitelist Options
- Register Deposit Source Address
- List Deposit Source Addresses
- Get Deposit Source Address
- Disable Deposit Source Address
- Submit Payer Details for a Received Deposit
- Save Sub-wallet Payer Profile
- Update Sub-wallet Payer Profile
- Get Sub-wallet Payer Profile
- Get Deposit Whitelist Case
- Get Asset Balance
- Get Deposit Address
- Add Deposit Sender
- Add Withdraw Whitelist
- Delete Withdraw Whiltelist
- Request Withdraw
- Query Wallet Internal Transfer Detail
- List Wallet Internal Transfer order
- Wallet Internal Transfer
- Create Sub Account
- Query Transaction History
- List Wallets
- List Sub Account
- Get Transaction Detail
- List Wallet Transactions
- Get Wallet Transaction Detail
- Payment Link
- Convert
- KYB
- Reconciliation
- External Provider
- FE: Create stablecoin collection sub-account link
- FE: Deposit Travel Rule
- External Provider · Deposit whitelist
- Create stablecoin collection sub-account link
- Get sub wallet account
- List sub wallet accounts
- Change sub wallet status
- Query stablecoin collection order list
- Query stablecoin collection order status
- Get quote
- Accept stablecoin collection order
- Reject stablecoin collection order
- Query USD balance
- USD Payout (withdrawal)
- Query USD Payout order status
- Query USD Payout order list
- Create deposit Travel Rule link
- Create deposit Travel Rule detail link
- Mock
- Pay Session
- Files
- Webhooks
- Webhooks Overview
- KYB notifications
- Event catalogue
- Resend Fail Webhook
- Open Virtual Account Status
- Virtual Account Payment Status
- Virtual Account Invoice update
- Transaction Status Notification
- KYB Status Notification
- Deposit Sender Detail Required
- Abnormal Fund Notification
- WALLET_TRANSFER_ORDER_UPDATED
- Sub Virtual Account RFI Required
- Sub Wallet Update
- wallet address whitelist Update
- Crypto Deposit Order Notification
- Collect Order Updated
- Usd Payout Order Updated
- onboard result
- partner order status
- PaymentLink Notification
- Deposit Whitelist Notification
- Partner Flow
- Appendix
- Release Notes & Changelog
- Errors
- Change Log
Submit hash
Developing
POST
/v1/stable/order/off-ramp/funding-notify
Notify BPN after Binance → BVI Ceffu withdrawal for an Off-ramp order; BPN runs internal fund flow and RD submit-hash.
Required: txHash.
Order id: merchantOrderId (recommended) or orderId — one required (same values as submit-order / query-detail).
Optional: binanceOrderId; optional binanceTravelRulesJson (JSON string); if omitted, BPN uses submit-order extInfo.travelRule.
Withdraw target: GET /v1/stable/order/query-detail → data.depositAddress only (not RD addresses).
Do not call RD submit-hash directly.
Request
Authorization
API Key
Add parameter in header
API-KEY
Example:
API-KEY: ********************API Key
Add parameter in header
API-SIGNATURE
Example:
API-SIGNATURE: ********************API Key
Add parameter in header
API-TIMESTAMP
Example:
API-TIMESTAMP: ********************or
Body Params application/jsonRequired
Example
{
"merchantOrderId": "BPN_RD_OFFRAMP_1788788907",
"txHash": "0x809f88e2595a45a88e5c917cbba94b2872a6f14b7706283af34ad11a1ee7f802",
"binanceOrderId": "BN_536264662597696",
"binanceTravelRulesJson": "{\"ogLegalName\":\"Sample Trading Limited\",\"ogRegNo\":\"4862431\",\"ogRegAddr\":\"1 Queen's Road Central, Hong Kong\",\"ogJurisdiction\":\"HK\",\"bfName\":\"Sample Trading Limited\",\"bfWalletAddr\":\"0xBVI_CEFFU_USDT_ADDRESS\",\"currency\":\"USDT\"}"
}Request Code Samples
Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location '/v1/stable/order/off-ramp/funding-notify' \
--header 'API-KEY: <api-key>' \
--header 'API-SIGNATURE: <api-key>' \
--header 'API-TIMESTAMP: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
"merchantOrderId": "BPN_RD_OFFRAMP_1788788907",
"txHash": "0x809f88e2595a45a88e5c917cbba94b2872a6f14b7706283af34ad11a1ee7f802",
"binanceOrderId": "BN_536264662597696",
"binanceTravelRulesJson": "{\"ogLegalName\":\"Sample Trading Limited\",\"ogRegNo\":\"4862431\",\"ogRegAddr\":\"1 Queen'\''s Road Central, Hong Kong\",\"ogJurisdiction\":\"HK\",\"bfName\":\"Sample Trading Limited\",\"bfWalletAddr\":\"0xBVI_CEFFU_USDT_ADDRESS\",\"currency\":\"USDT\"}"
}'Responses
🟢200Success
application/json
Bodyapplication/json
Examples
{
"status": 200,
"msg": "OK",
"code": null,
"data": true,
"traceId": "Auto:1ba9978cb93540578d5105031838c53c",
"success": true
}