Skip to content
Virtual Account API

Virtual Account API: a unique VA number for every order.

The buyer transfers to a Virtual Account number from their bank app and the order is marked paid automatically. No more checking statements or asking for transfer receipts.

Try it first with a test key and no real money.

Create a Virtual AccountPOST /v1/transactions
curl https://api.fintar.id/v1/transactions \
  -H "Authorization: Bearer ft_test_..." \
  -H "Idempotency-Key: order-1234" \
  -H "Content-Type: application/json" \
  -d '{
    "order_items": [
      { "name": "Kaos polos", "price": 75000, "quantity": 2 }
    ],
    "external_id": "ORD-1234",
    "payment_methods": ["va_mandiri"],
    "customer": { "name": "Budi", "email": "budi@toko.dev" }
  }'
How it works

Three steps from order to paid.

  1. Create the transaction

    Send POST /v1/transactions with a bank code, such as va_bni or va_mandiri, and the buyer's name.

  2. Show the VA number

    The response carries the payment_code and the bank name. Show both with the amount on your payment page.

  3. Receive the webhook

    The payment.paid event is sent to your server once the transfer is received. The order can be fulfilled right away.

What you get

The same request for every bank.

  • Seven banks. BRI, BNI, Mandiri, Permata, CIMB Niaga, Danamon and Maybank.
  • One code per bank. Every bank is the same request with a different code in payment_methods.
  • Buyer name required. A Virtual Account shows the buyer's name, so customer.name must be sent.
  • Rp10,000 to Rp10,000,000. The default amount limits per payment. Need a higher maximum? Email halo@fintar.id.
  • Locked amount. Each VA number is tied to one transaction and one amount.
Response201 Created
{
  "id": "payreq_9b2f...",
  "status": "pending",
  "payment_method": "va_mandiri",
  "payment": {
    "type": "payment_code",
    "payment_code": "8890812345678901",
    "bank": "Mandiri",
    "display_name": "Mandiri Virtual Account"
  },
  "expires_at": "2026-08-28T12:00:00+07:00"
}
Basics

Why a Virtual Account instead of a manual transfer?

With a manual transfer, the buyer sends money to an ordinary account and then sends a receipt. The seller has to open the statement, match the amount and mark orders one by one.

A Virtual Account is a transfer destination created for a single order. As soon as the buyer pays to that number, the system knows which order was paid.

With the Fintar Virtual Account API, the VA number is created in one request and the result is sent to your server by webhook. Reconciliation runs without manual work.

FAQ

Questions about the Virtual Account API

Which banks does Fintar Virtual Account support?

BRI, BNI, Mandiri, Permata, CIMB Niaga, Danamon and Maybank. The banks active for an account are always available from GET /v1/payment_methods.

What are the minimum and maximum Virtual Account amounts?

A minimum of Rp10,000 and a maximum of Rp10,000,000 per payment. For a higher maximum, email halo@fintar.id.

Can the buyer pay from a different bank?

A Virtual Account number is paid through the bank that issued it. For buyers on another bank or an e-wallet, offer QRIS as well, which can be paid from any app that supports QRIS.

How do I test Virtual Account without real money?

Use a test key starting with ft_test_. In Sandbox a payment can be simulated as paid or expired without a real transfer.

Can a Virtual Account payment be refunded?

A Virtual Account payment cannot be reversed or refunded through Fintar. The merchant returns the money by transfer from their own bank account, outside Fintar.

Stop matching transfer receipts.

Create an account, grab a test key and create your first Virtual Account number in minutes.