1. Virtual Account
BPN OpenAPI
  • Get started
    • Introduction to BPN
    • Introduction to API
    • Architecture Overview
    • Authentication
    • Environments
    • Response envelope
    • Idempotency
  • Guides
    • Virtual Account
      • Virtual Account Overview
      • VA · Payin
      • VA · Statuses
      • VA · Payout
      • VA · RFI
      • VA · Currencies & limits
      • VA Opening
        • VND VA Opening
        • BRL VA Opening
    • Wallet
      • Wallet · Transfer
      • Wallet · Assets & limits
      • Wallet · Deposit whitelist
      • Wallet · PaymentLink
      • Wallet Overview
      • Wallet · Deposit
      • Wallet · Statuses
      • Wallet · Withdraw
    • Convert
      • Convert Overview
      • Convert · Quote & submit
      • Convert · Business types
      • Convert · Pairs & limits
      • Convert · Statuses
  • API Reference
    • Virtual Account
      • Virtual Account field notes
      • Inquiry Master VA Balance
        GET
      • List Primary Virtual Accounts
        GET
      • Create Virtual Account
        POST
      • Get Virtual Account Detail
        GET
      • List Virtual Account
        GET
      • List Virtual Account Orders
        GET
      • Get Virtual Account Order Detail
        GET
      • Refund Virtual Account Order
        POST
      • List RFI Sub Virtual Account
        GET
      • Get Sub Virtual Account RFI Template Info
        GET
      • Sub Virtual Account Submit RFI
        POST
      • Add Bank Account
        POST
      • List Bank Account
        GET
      • List Banks
        GET
      • Payout via Virtual Account
        POST
      • Send Email Verify Code
        POST
    • 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
      • Abnormal fund
        • Abnormal funds
        • Matchable Payment links
        • Link Order(Abnormal fund)
        • Submit to platform
      • Create Payment Link
      • List Payment links
      • Get Curreny Network Config
      • Prepay Whitelist for One-Time Payment Link
      • Prepay Whitelist for Permanent Payment Link
    • Convert
      • Convert field notes
      • Inquery FX Rate
      • Get Stablecoin Quote
      • Create Stable Order
      • Get Order (Single) Detail
      • List Orders(Batch)
    • KYB
      • Share KYB/KYC Info For Sub User
      • Get KYB Sub User Status
    • Reconciliation
      • Get Reconciliation Order List By Page
    • 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
      • Mock Virtual account Payin Order
      • Mock wallet deposit transaction
      • Mock Payment Link deposit
      • Mock Payin Order Refund
      • Mock Payout Order Update Status
    • Pay Session
      • Request Pay Session
    • Files
      • Request File Upload URL
  • 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
    • Share KYB/KYC and open account directly
    • Get KYB/KYC submit + open account status
    • List Banks
    • Check Account
    • Add Account
    • Get Stablecoin Quote
    • Create Stable Order
    • Get Order (Single) Detail
    • List Orders(Batch)
    • Submit hash
    • Order Status Notification (STABLE_ORDER_UPDATED)
  • Appendix
    • Enums quick reference
    • Enum
    • Virtual Account(VA) Support List & KYB requirement
  • Release Notes & Changelog
  • Errors
    • Error codes catalogue
  • Change Log
    • 2026-09-21 Virtual Account independent refund orders
    • Wallet deposit source-address whitelist
  1. Virtual Account

Get Sub Virtual Account RFI Template Info

GET
/v1/virtual-account/sub/rfi-template

Get Sub VA RFI Template#

GET /v1/virtual-account/sub/rfi-template
Load the RFI question checklist for the current Sub Virtual Account. For AVENIA BRL SUB_ACCOUNT_RFI_TIER_1, Individual and Business use different question ids for registration, UBO identity, trade documents, company address, and additional information. Do not hard-code ids from the samples — always load them from this API for the current virtualAccountId / channel.

How to use#

1.
Call after Sub Virtual Account RFI Required or List RFI Sub Virtual Account when rfiStatus is submittable (AWAITING_SUBMISSION, RESUBMIT_REQUIRED). Reload again before a limit-increase submit.
2.
Query:
bizTypeList = webhook data.awaitingRfiTypeList (example SUB_ACCOUNT_RFI_TIER_1)
virtualAccountId = webhook data.virtualAccountId or list accountId
currency = webhook data.currency (AVENIA sample: BRL)
3.
Build one submit row per answerable question:
questions[].id → answerList[].questionId (exact)
template bizType → answerList[].bizType
type = FILE → base64Files and/or file
type = TEXT → answer
Honor required = true
4.
Skip every SUB TITLE row. These are section headers, not answers:
RFI_TIER1_Section_Company_Identity
RFI_TIER1_Section_Business_Transaction
RFI_TIER1_Section_Address_Financial_Tax
5.
requestedMonthlyLimit is not a template question. Send it on Sub Virtual Account Submit RFI only when limitIncrease = true.

Example request#

Response examples#

ExampleWho it is for
avenia-brl-individualAVENIA BRL TIER_1 Individual
avenia-brl-businessAVENIA BRL TIER_1 Business
Examples include SUB TITLE section headers. Do not send those question ids on submit.

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 '/v1/virtual-account/sub/rfi-template?bizTypeList=SUB_ACCOUNT_RFI_TIER_1&currency=BRL&virtualAccountId=3100'

Responses

🟢200OK
application/json
Bodyapplication/json

Examples
{
    "status": 200,
    "code": null,
    "msg": "OK",
    "data": [
        {
            "id": 10001,
            "currency": "BRL",
            "bizType": "SUB_ACCOUNT_RFI_TIER_1",
            "channelCode": "AVENIA",
            "questions": [
                {
                    "id": "RFI_TIER1_Business_Website_App_Or_Store_Url",
                    "type": "TEXT",
                    "label": "Business Website, App or Store URL",
                    "required": true,
                    "width": "full",
                    "description": "Enter a website, app, or marketplace store URL."
                },
                {
                    "id": "RFI_TIER1_Section_Company_Identity",
                    "type": "SUB TITLE",
                    "label": "Company & Identity Documents",
                    "required": false
                },
                {
                    "id": "RFI_TIER1_Company_Registration_Documents",
                    "type": "FILE",
                    "label": "Company Registration Documents",
                    "required": true,
                    "width": "full",
                    "parentSubtitleId": "RFI_TIER1_Section_Company_Identity",
                    "description": "e.g. Contrato Social for Brazil, Business License for Mainland China, Certificate of Incorporation for Hong Kong, or equivalent official company registration documents"
                },
                {
                    "id": "RFI_TIER1_Individual_Identity_Document",
                    "type": "FILE",
                    "label": "Legal Representative and UBO Proof of Identity",
                    "required": true,
                    "width": "full",
                    "parentSubtitleId": "RFI_TIER1_Section_Company_Identity",
                    "description": "e.g. Passport, ID Card, Driver's License, Residence Permit, Permanent Resident Card, RG, RNM/RNE, or CIN for the legal representative and all UBOs."
                },
                {
                    "id": "RFI_TIER1_Articles_of_Association_Ownership_Documents",
                    "type": "FILE",
                    "label": "Articles of Association / Ownership Documents",
                    "required": true,
                    "width": "full",
                    "parentSubtitleId": "RFI_TIER1_Section_Company_Identity",
                    "description": "e.g. Articles of Association / Ownership Register for Mainland China, the latest Annual Return or NNC1 for Hong Kong, Contrato Social for Brazil, or equivalent documents showing the current directors, shareholders, and UBOs."
                },
                {
                    "id": "RFI_TIER1_Section_Business_Transaction",
                    "type": "SUB TITLE",
                    "label": "Business & Transaction Documents",
                    "required": false
                },
                {
                    "id": "RFI_TIER1_Individual_Business_Proof",
                    "type": "FILE",
                    "label": "B2B Trade Documents",
                    "required": true,
                    "width": "full",
                    "parentSubtitleId": "RFI_TIER1_Section_Business_Transaction",
                    "description": "Upload recent commercial invoices for the merchant's 3 most recent transactions. Each invoice must show the buyer's name and include the matching Bill of Lading or Air Waybill. For a higher monthly limit, include additional commercial invoices issued by the merchant within the last 3 months and their matching shipping documents."
                },
                {
                    "id": "RFI_TIER1_Marketplace_Service_Fee_Invoices",
                    "type": "FILE",
                    "label": "Marketplace Service Fee Invoices",
                    "required": true,
                    "width": "full",
                    "parentSubtitleId": "RFI_TIER1_Section_Business_Transaction",
                    "description": "Upload platform service fee invoices issued by the marketplace to the merchant for the last 3 months."
                },
                {
                    "id": "RFI_TIER1_Website_Or_App_Business_Documents",
                    "type": "FILE",
                    "label": "Website or App Business Documents",
                    "required": true,
                    "width": "full",
                    "parentSubtitleId": "RFI_TIER1_Section_Business_Transaction",
                    "description": "Upload website or app ownership proof and sales reports covering all payment channels for the last 3 months."
                },
                {
                    "id": "RFI_TIER1_Nfe_Nfte_Supporting_Invoices",
                    "type": "FILE",
                    "label": "NF-e / NFT-e Supporting Invoices",
                    "required": true,
                    "width": "full",
                    "parentSubtitleId": "RFI_TIER1_Section_Business_Transaction",
                    "description": "Upload the last 3 months supporting invoices (NF-e for services and digital content) issued by the merchant within the last 3 months. Upload original XML files in ZIP or PDF format covering the same period."
                },
                {
                    "id": "RFI_TIER1_Section_Address_Financial_Tax",
                    "type": "SUB TITLE",
                    "label": "Address, Financial & Tax Documents",
                    "required": false
                },
                {
                    "id": "RFI_TIER1_Individual_Address_Proof",
                    "type": "FILE",
                    "label": "Company Proof of Address",
                    "required": true,
                    "width": "full",
                    "parentSubtitleId": "RFI_TIER1_Section_Address_Financial_Tax",
                    "description": "e.g. a utility bill, bank statement, or government letter issued in the company's name within the last 3 months. For Brazil, CNPJ Registration Card is not accepted. A valid Business Registration Certificate for Hong Kong, or Business License for Mainland China."
                },
                {
                    "id": "RFI_TIER1_UBO_Proof_of_Address",
                    "type": "FILE",
                    "label": "UBO Individual Proof of Address",
                    "required": true,
                    "width": "full",
                    "parentSubtitleId": "RFI_TIER1_Section_Address_Financial_Tax",
                    "description": "e.g. both sides of the Resident Identity Card for Mainland China UBOs, a utility bill or bank statement issued in the UBO's name within the last 3 months for other UBOs, or valid individual address proof for individual merchants."
                },
                {
                    "id": "RFI_TIER1_Financial_Statements_Balance_Sheet",
                    "type": "FILE",
                    "label": "Financial Statements / Balance Sheet",
                    "required": true,
                    "width": "full",
                    "parentSubtitleId": "RFI_TIER1_Section_Address_Financial_Tax",
                    "description": "Upload the latest financial statements or balance sheet demonstrating the company's financial capacity."
                },
                {
                    "id": "RFI_TIER1_Personal_Income_Tax_Return",
                    "type": "FILE",
                    "label": "Personal Income Tax Return",
                    "required": true,
                    "width": "full",
                    "parentSubtitleId": "RFI_TIER1_Section_Address_Financial_Tax",
                    "description": "Upload the individual merchant's latest personal income tax return."
                },
                {
                    "id": "RFI_TIER1_Individual_Additional_Information",
                    "type": "TEXT",
                    "label": "Additional Information",
                    "required": false,
                    "width": "full",
                    "description": "Please provide any additional details required for verification."
                }
            ]
        }
    ],
    "traceId": "39d760f9a1814c4896a774bcf79da528",
    "success": true,
    "message": "OK"
}
Previous
List RFI Sub Virtual Account
Next
Sub Virtual Account Submit RFI
Built with