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.
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...", ... }
One request, one redirect.
Create the transaction
Send POST /v1/transactions with the order and a return_url. The response carries a checkout_url.
Redirect the buyer
Send the buyer to checkout_url. They choose QRIS or Virtual Account and pay on that page.
Receive the webhook
The payment.paid event is sent to your server, and the buyer returns to return_url.
Fintar Checkout or the Direct API?
Both use the same endpoint. The only difference is who shows the payment page.
Fintar Checkout
The quickest to install. The payment page is hosted and maintained by Fintar, and the buyer picks the method. Right for most online stores.
Checkout documentationDirect API
Full control of the interface. The QRIS code or Virtual Account number is shown on your own page, with no redirect.
Direct API documentationA 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.
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.