1. External Provider
BPN OpenAPI
  • Getting Started
    • Introduction to BPN
    • Key Concepts & Terminology
    • Architecture Overview
  • Onboarding & Prerequisites
    • Product Demo
    • Sandbox & Test Environment
    • Signature Authentication Mechanism
  • Use Case
    • Transfer
    • Vault
    • On/Off Ramp
    • Compliance (Travel Rule Information Submission)
    • Fiat Collection(BRL PIX for example)
  • API Reference
    • KYB
      • Share KYB/KYC Info For Sub User
      • Get KYB Sub User Status
    • Account Management
      • Inquiry Master VA Balance
      • Create Virtaul Account
      • Get Virtual Account Detail
      • List Virtual Account
      • Send Email Verify Code
      • Query bank info by account number
      • Payout via Virtual Account
      • Refund Virtual Account Order
      • Get Virtual Account Order Detail
      • List Virtual Account Orders
      • Submit Invoice
      • Get Invoice list Status
      • List Banks
      • Add Bank Account
      • List Bank Account
      • List RFI Sub Virtual Account
      • Get Sub Virtual Account RFI Template Info
      • Sub Virtual Account Submit RFI
    • Wallet
      • List Wallets
      • List Sub Account
      • Create Sub Account
      • Wallet Internal Transfer
      • Query Wallet Internal Transfer Detail
      • List Wallet Internal Transfer order
      • Get Asset Balance
      • Get Deposit Address
      • Add Deposit Sender
      • Add Withdraw Whitelist
      • Delete Withdraw Whiltelist
      • Request Withdraw
      • Query Transaction History
    • FX
      • Inquery FX Rate
    • BPN Transactions
      • Get Stablecoin Quote
      • Create Stable Order
      • Get Order (Single) Detail
      • List Orders(Batch)
    • Reconciliation
      • Get Reconciliation Order List By Page
    • Crypto Payment Link
      • Abnormal fund
        • Abnormal funds
        • Matchable Payment links
        • Link Order(Abnormal fund)
        • Submit to platform
      • Create Payment Link
      • List Payment links
      • Get Curreny Network Config
    • External Provider
      • FE: Create stablecoin collection sub-account link
      • Create stablecoin collection sub-account link
        POST
      • Get sub wallet account
        GET
      • List sub wallet accounts
        GET
      • Change sub wallet status
        POST
      • Query stablecoin collection order list
        GET
      • Query stablecoin collection order status
        GET
      • Get quote
        GET
      • Accept stablecoin collection order
        POST
      • Reject stablecoin collection order
        POST
      • Query USD balance
        GET
      • USD Payout (withdrawal)
        POST
      • Query USD Payout order status
        GET
      • Query USD Payout order list
        GET
    • Mock
      • Mock Virtual account Payin Order
      • Mock wallet deposit transaction
      • Mock Payin Order Refund
      • Mock Payout Order Update Status
    • Pay Session
      • Request Pay Session
  • Webhooks & Events
    • 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 Copy
    • Crypto Deposit Order Notification
    • Collect Order Updated
    • Usd Payout Order Updated
  • Appendix
    • Enum
    • Virtual Account(VA) Support List & KYB requirement
  • Release Notes & Changelog
    • Version History
  • Schemas
    • walletBalance
    • walletAddress
    • transactionRecord
  1. External Provider

Get sub wallet account

GET
/v2/stable/wallet/sub-wallet/account
Get sub wallet account. Pass walletId or externalAccountId (one required).

Request

Query Params

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 --request GET '/v2/stable/wallet/sub-wallet/account?walletId&externalAccountId'

Responses

🟢200OK
application/json
Success
Body

Example
{
    "status": 200,
    "code": null,
    "msg": "OK",
    "data": {
        "accountName": "TestSubWallet1772688467",
        "walletId": "3095",
        "externalAccountId": "ex1772688467",
        "status": "active",
        "paymentLinkList": [
            {
                "currency": "USDC",
                "paymentLink": "https://sandbox.bpn.finance/en/pay-to?authToken=EAXfqDCCDcdXZI3MFO5Tco5gcoZxvuJgQuPgXcFs06pEeeBR7BgVdCG0JNglR0oNCfiEcTy7bUJ1ssQ%3D&orderId=PAY2026030505596452464956138496"
            },
            {
                "currency": "USDT",
                "paymentLink": "https://sandbox.bpn.finance/en/pay-to?authToken=P4p9sqMKkuTsZI5tvW0weTApHXh17H5YQuSXq5nfKGoxq5%2BqjtP053wRNlcRNmgGgkoDcu3bQ9BCD70%3D&orderId=PAY2026030505596452509214434304"
            }
        ],
        "supportNetworkList": [
            {
                "currency": "USDC",
                "network": "BSC",
                "address": "mock_address_11111",
                "tag": "mock"
            },
            {
                "currency": "USDC",
                "network": "ETH",
                "address": "mock_address_11111",
                "tag": "mock"
            },
            {
                "currency": "USDC",
                "network": "SOL",
                "address": "mock_address_11111",
                "tag": "mock"
            },
            {
                "currency": "USDC",
                "network": "ARB",
                "address": "mock_address_11111",
                "tag": "mock"
            },
            {
                "currency": "USDC",
                "network": "SUI",
                "address": "mock_address_11111",
                "tag": "mock"
            },
            {
                "currency": "USDC",
                "network": "BASE",
                "address": "mock_address_11111",
                "tag": "mock"
            },
            {
                "currency": "USDT",
                "network": "BSC",
                "address": "111",
                "tag": "1"
            },
            {
                "currency": "USDT",
                "network": "ETH",
                "address": "mock_address_11111",
                "tag": "mock"
            },
            {
                "currency": "USDT",
                "network": "TRON",
                "address": "mock_address_11111",
                "tag": "mock"
            },
            {
                "currency": "USDT",
                "network": "SOL",
                "address": "mock_address_11111",
                "tag": "mock"
            },
            {
                "currency": "USDT",
                "network": "TON",
                "address": "mock_address_11111",
                "tag": "mock"
            },
            {
                "currency": "USDT",
                "network": "ARB",
                "address": "mock_address_11111",
                "tag": "mock"
            }
        ]
    },
    "traceId": "Auto:2300f75c6a28469e8dfa5401d2c60d0d",
    "success": true
}
Previous
Create stablecoin collection sub-account link
Next
List sub wallet accounts
Built with