Midtrans

The ways Indonesia pays

Midtrans is one of Indonesia's main payment gateways. The plugin uses Midtrans Snap, its hosted payment page, which shows the methods Midtrans has activated for your account: cards, GoPay, ShopeePay, QRIS, bank transfer to a virtual account, and payment at Indomaret or Alfamart. The money is paid into your own Midtrans account, and the booking shows which method the traveller used.

Rupiah only

Midtrans takes payments in IDR, so it appears at checkout only for tours with an IDR price. Midtrans works in whole rupiah, so amounts are rounded to the nearest rupiah. If your website sells in another currency, the plugin's status panel says so; add IDR with the Currency switcher.

Checkout and confirmation

For each payment Tourtify creates a Snap transaction with the amount, the traveller's email and your booking reference. Its expiry matches the time Tourtify holds the seats, at least 15 minutes, so a virtual account number or store code stops working when the seats are released.

The traveller pays on the Snap page and returns to your website. Tourtify then asks Midtrans's status API about the payment. A settled payment confirms the booking, and so does a card payment that Midtrans's fraud detection accepts. A card payment that it challenges is held and flagged for your team: accept or deny it in the Midtrans dashboard. Denied, cancelled, expired and failed payments are closed, so the traveller can try again. E-wallet, QRIS and 3-D Secure payments that are still pending are checked again.

Bank transfers and store payments

A virtual account transfer or an Indomaret or Alfamart payment is made after the traveller leaves the Snap page. While Midtrans reports it pending, the booking keeps its seats and Tourtify keeps checking. When the traveller pays, the booking confirms; if the payment expires unpaid, the seats are released.

Notifications without set-up

Every Snap transaction tells Midtrans which address to notify for that payment, so there is nothing to configure in your Midtrans dashboard. Each notification's signature, a SHA-512 hash made with your server key, is checked, and the notification must be for one of your business's payments. It only tells Tourtify to check the payment again, so a forged message can't mark anything paid.

Refunds

Card and e-wallet payments can be refunded from the booking. Each refund is sent to Midtrans with Tourtify's refund ID as its refund key. Midtrans can't refund bank transfers or convenience store payments automatically: pay the traveller back by bank transfer, then choose "I refunded it in the provider's dashboard" on the booking so the traveller's balance and your reports stay correct. Do the same for any refund you make in the Midtrans dashboard.

Sandbox and production

Midtrans gives every account a sandbox with its own server key, starting SB-Mid-server-, and a production key starting Mid-server-. Tourtify checks that the key matches the mode you chose and checks it with Midtrans before saving. In Test mode payments go to Midtrans's sandbox, where no real money moves.

Setting up Midtrans

1. 1Copy your sandbox server key. In the Midtrans Dashboard, switch to the sandbox environment and open Settings › Access keys.
2. 2Connect in Test mode. On the Payments page, add Midtrans, paste the SB-Mid-server- key and choose Test.
3. 3Price a tour in IDR. Add IDR with the Currency switcher if needed and give the tour a rupiah price.
4. 4Make a sandbox booking. Pay with a Midtrans test card or its sandbox simulator and check the booking confirms.
5. 5Switch to Production. Update the key with the Mid-server- key from your production environment and choose Live.