List

curl --request GET \
  --url https://sandbox-payment-b2b.singapay.id/api/v1.0/va-transactions/{account_id} \
  --header 'Authorization: Bearer <token>' \
  --header 'X-PARTNER-ID: <api-key>'

{
  "status": 200,
  "success": true,
  "data": [
    {
      "transaction_id": "VA-20251024-0001H9X8ZK",
      "merchant_reff_no": "INV/2025/10/0001",
      "va_number": "88810012345678",
      "account": {
        "id": "01H9X8ZK3M7QF4N2VTB6RYJWPC",
        "name": "Toko Sumber Rejeki",
        "email": "finance@sumberrejeki.co.id",
        "phone": "081234567890"
      },
      "bank": {
        "short_name": "BRI",
        "number": "002",
        "swift_code": "BRINIDJA",
        "bank_code": "BRI"
      },
      "notes": "Pembayaran order #1024",
      "status": "paid",
      "fees": {
        "name": "BRI Virtual Account",
        "amount": 4500,
        "currency": "IDR"
      },
      "amount": {
        "value": "1234.56",
        "currency": "IDR"
      },
      "post_timestamp": "1729748679474",
      "processed_timestamp": "1729748707000",
      "has_settle": true,
      "settle_at": 1729753200000
    }
  ],
  "pagination": {}
}

VA Transaction

List

Retrieve a paginated list of Virtual Account money-in transactions for an account. Each entry represents a single payment a customer made into one of the account’s Virtual Accounts.

Results are restricted to transactions created within the last 12 months and are ordered newest-first by default. Use the query parameters below to paginate, sort, and filter the result set; pagination details are returned in the response meta object.

The following optional filters are available and may be combined: transaction_id (partial match), merchant_reff_no (partial match), va_number (exact match), status, amount, amount_min, amount_max, has_settle, post_timestamp_from/post_timestamp_to, processed_timestamp_from/processed_timestamp_to, and settle_at_from/settle_at_to. All timestamp filters accept a Unix timestamp in milliseconds and define an inclusive range.

GET

api

v1.0

va-transactions

{account_id}

List

curl --request GET \
  --url https://sandbox-payment-b2b.singapay.id/api/v1.0/va-transactions/{account_id} \
  --header 'Authorization: Bearer <token>' \
  --header 'X-PARTNER-ID: <api-key>'

{
  "status": 200,
  "success": true,
  "data": [
    {
      "transaction_id": "VA-20251024-0001H9X8ZK",
      "merchant_reff_no": "INV/2025/10/0001",
      "va_number": "88810012345678",
      "account": {
        "id": "01H9X8ZK3M7QF4N2VTB6RYJWPC",
        "name": "Toko Sumber Rejeki",
        "email": "finance@sumberrejeki.co.id",
        "phone": "081234567890"
      },
      "bank": {
        "short_name": "BRI",
        "number": "002",
        "swift_code": "BRINIDJA",
        "bank_code": "BRI"
      },
      "notes": "Pembayaran order #1024",
      "status": "paid",
      "fees": {
        "name": "BRI Virtual Account",
        "amount": 4500,
        "currency": "IDR"
      },
      "amount": {
        "value": "1234.56",
        "currency": "IDR"
      },
      "post_timestamp": "1729748679474",
      "processed_timestamp": "1729748707000",
      "has_settle": true,
      "settle_at": 1729753200000
    }
  ],
  "pagination": {}
}

Authorizations

Authorization

string

header

required

JWT issued by POST /api/v1.1/access-token/b2b. Send Authorization: Bearer <token>.

X-PARTNER-ID

string

header

required

Merchant API key (Credential.api_key). Required on every request.

Path Parameters

account_id

string

required

ULID of the account whose VA transactions are being listed. Must belong to the authenticated merchant. Account ULID

Example:

"01H9X8ZK3M7QF4N2VTB6RYJWPC"

Query Parameters

per_page

integer

default:25

Number of items per page.

Example:

25

sort_by

string

default:id

Column to sort by (e.g. id, created_at, amount, post_timestamp).

Example:

"id"

sort_order

enum<string>

default:desc

Sort direction.

Available options:

asc,

desc

transaction_id

string

Filter by business transaction id (partial/substring match).

Example:

"VA-20251024"

merchant_reff_no

string

Filter by merchant reference number (partial/substring match).

Example:

"INV-2025-001"

va_number

string

Filter by Virtual Account number (exact match).

Example:

"88810012345678"

status

enum<string>

Filter by exact transaction status.

Available options:

unpaid,

paid,

expired,

failed

Example:

"paid"

amount

number

Filter by exact transaction amount (IDR).

Example:

1200000

amount_min

number

Filter by minimum transaction amount (IDR), inclusive.

Example:

100000

amount_max

number

Filter by maximum transaction amount (IDR), inclusive.

Example:

5000000

has_settle

boolean

Filter by settlement state. True returns only transactions already settled to the merchant balance.

Example:

true

post_timestamp_from

integer

Lower bound (inclusive) on the posted time, as a Unix timestamp in milliseconds.

Example:

1729728000000

post_timestamp_to

integer

Upper bound (inclusive) on the posted time, as a Unix timestamp in milliseconds.

Example:

1729814400000

processed_timestamp_from

integer

Lower bound (inclusive) on the processed time, as a Unix timestamp in milliseconds.

Example:

1729728000000

processed_timestamp_to

integer

Upper bound (inclusive) on the processed time, as a Unix timestamp in milliseconds.

Example:

1729814400000

settle_at_from

integer

Lower bound (inclusive) on the settlement time, as a Unix timestamp in milliseconds.

Example:

1729728000000

settle_at_to

integer

Upper bound (inclusive) on the settlement time, as a Unix timestamp in milliseconds.

Example:

1729814400000

Response

Success

Standard success envelope wrapping a paginated list of VA transactions.

status

integer

required

HTTP status code of the response.

Example:

200

success

boolean

required

Always true for successful responses.

Example:

true

data

object[]

required

The list of VA transactions for the current page.

Show child attributes

pagination

object

Pagination metadata for the collection — current page, per-page size, total item count, and total page count (Laravel paginator output).

Overview

Show