Get Invoice list Status

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:

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")

Lookup by order ID
Retrieve a single order’s invoice submission details by specifying its unique identifier.

Default
If no status/id is provided, endpoint will return all orders under REQUIRED and RESUBMIT, which require new invoice files.

Request

Authorization

API Key

Add parameter in header

X-BPN-API-KEY

Example:

X-BPN-API-KEY: ********************

API Key

Add parameter in header

X-BPN-SIGNATURE

Example:

X-BPN-SIGNATURE: ********************

API Key

Add parameter in header

X-BPN-TIMESTAMP

Example:

X-BPN-TIMESTAMP: ********************

Query Params

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200Success

application/json

Bodyapplication/json

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"
}