Skip to content
Fintar Checkout

Fintar Checkout: a payment page you only redirect to.

Create a transaction, send the buyer to checkout_url, and wait for the webhook. Fintar shows the method choice, the QRIS code, the Virtual Account number and the payment status.

The fastest way to add payments to a website or app.

Create a checkout sessionPOST /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",
    "return_url": "https://toko.example/selesai",
    "customer": { "name": "Budi", "email": "budi@toko.dev" }
  }'

# 201: redirect the buyer to checkout_url
# { "id": "payreq_9b2f...", "checkout_url": ".../p/xK3f...", ... }
How it works

One request, one redirect.

  1. Create the transaction

    Send POST /v1/transactions with the order and a return_url. The response carries a checkout_url.

  2. Redirect the buyer

    Send the buyer to checkout_url. They choose QRIS or Virtual Account and pay on that page.

  3. Receive the webhook

    The payment.paid event is sent to your server, and the buyer returns to return_url.

What you control

A ready-made page that still follows your flow.

  • Collect buyer details. Ask for name and email on the checkout page, and decide which are required.
  • Prefill what you know. Send buyer details you already have so they are not typed again.
  • Limit the methods. Offer every active method, or only the ones you pass in payment_methods.
  • Back to your store. After paying, the buyer is sent to return_url.
FAQ

Questions about Fintar Checkout

What is the difference between Fintar Checkout and the Direct API?

With Fintar Checkout the buyer is redirected to a payment page hosted by Fintar. With the Direct API the QRIS code or Virtual Account number is shown on the merchant's own page. Both use the same endpoint and the same webhook.

Do I need to build my own payment interface?

No. Fintar Checkout already shows the method choice, the payment instructions and the status. Your server only creates the transaction and receives the webhook.

Which methods appear on the checkout page?

The QRIS and Virtual Account methods active on the account. The list can be limited per transaction through payment_methods.

How does my website know the payment succeeded?

Through the payment.paid webhook sent to your server. Do not rely on the redirect to return_url alone, because a buyer can close the page before returning.

Can Fintar Checkout be tested without real money?

Yes. With a test key starting with ft_test_ the checkout page runs in Sandbox and payments can be simulated.

Add payments without building a payment page.

Create an account, grab a test key and send your first buyer to Fintar Checkout.