BPN OpenAPI
  1. Account Management
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
    • Account Management
      • Inquiry Master VA Balance
        GET
      • Create Virtaul Account
        POST
      • Get Virtual Account Detail
        GET
      • List Virtual Account
        GET
      • Send Email Verify Code
        POST
      • Query bank info by account number
        POST
      • Payout via Virtual Account
        POST
      • Refund Virtual Account Order
        POST
      • Get Virtual Account Order Detail
        GET
      • List Virtual Account Orders
        GET
      • Submit Invoice
        POST
      • Get Invoice list Status
        GET
      • List Banks
        GET
      • Add Bank Account
        POST
      • List Bank Account
        GET
      • List RFI Sub Virtual Account
        GET
      • Get Sub Virtual Account RFI Template Info
        GET
      • Sub Virtual Account Submit RFI
        POST
    • Wallet
      • List Wallets
      • List Sub Account
      • Create Sub Account
      • Wallet Internal Transfer
      • 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
      • Create Payment Link
      • List Payment links
      • Get Curreny Network Config
    • Mock
      • Mock Virtual account Payin Order
  • 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
  • Appendix
    • Enum
    • Virtual Account(VA) Support List & KYB requirement
  • Release Notes & Changelog
    • Version History
  • Schemas
    • walletBalance
    • walletAddress
    • transactionRecord
  1. Account Management

Get Invoice list Status

GET
/v1/virtual-account/invoice/list
The Get Invoice Submission Status API allows merchants to retrieve the current status of invoice submissions related to their orders.
This can be done in three ways:
1.
Filter by status
Retrieve a list of orders based on their invoice submission status (e.g. REQUIRED, REVIEWING). If merchnat want to search mutiple status, it's allowed to input them split by comma (eg. "status":"PASS,FAIL")
2.
Lookup by order ID
Retrieve a single order’s invoice submission details by specifying its unique identifier.
3.
Default
If no status/id is provided, endpoint will return all orders under REQUIRED and RESUBMIT, which require new invoice files.

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 '/v1/virtual-account/invoice/list?status=REVIEWING&invoiceId=38'

Responses

🟢200Success
application/json
Body

Example
{
    "status": 200,
    "message": "OK",
    "data": {
        "invoiceList": [
            {
                "invoiceId": "38",
                "accountId": "1000001234",
                "orderId": "ORD202509240001",
                "time": "2025-09-24T10:30:00Z",
                "amount": "1500.75",
                "currency": "USD",
                "fromAccountName": "John Doe",
                "fromAccountNumber": "123-456-7890",
                "toAccountName": "Paymonade Ltd",
                "status": "REQUIRED"
            },
            {
                "invoiceId": "39",
                "accountId": "1000005678",
                "orderId": "ORD202509240002",
                "time": "2025-09-23T15:45:00Z",
                "amount": "320.00",
                "currency": "EUR",
                "fromAccountName": "Alice Smith",
                "fromAccountNumber": "987-654-3210",
                "toAccountName": "Paymonade Ltd",
                "status": "FAIL",
                "reason": "Reject by vendor",
                "file": [
                    "https://xxx.pdf"
                ]
            }
        ]
    },
    "traceId": "string"
}
Previous
Submit Invoice
Next
List Banks
Built with