Skip to main content

Midtrans

Instructions for Connecting Midtrans

The OneEntry Platform supports integration with the Indonesian payment system Midtrans. Choose this type of payment account if you want to accept payments through Midtrans.

Create a Payment Account with Midtrans Type​

Instructions on how to create a payment account can be found here. In the "Type" field, select Midtrans.

Fill in the Account Settings​

Open the created payment account for editing. In the Details section, specify:

  • Success URL — the address to which the customer will return after a successful payment.
  • Cancel URL — the address to which the customer will return if the payment is canceled.
  • Session timeout — the lifespan of the payment session, after which the unpaid session becomes invalid.

Connect Midtrans​

In the Connect Midtrans section, provide the credentials from your Midtrans personal account (Merchant Administration Portal → Settings → Access Keys):

  • Testing mode — testing mode. While the checkbox is checked, the connection works with Midtrans test (Sandbox) keys; uncheck it to accept real payments.
  • Server Key — the server key for your Midtrans account.
  • Available Payment Methods — payment methods that will be available to the customer. This field is mandatory — select at least one method. Available options include: credit_card, gopay, qris, shopeepay, bank_transfer, virtual bank accounts (bca_va, bni_va, bri_va, permata_va, cimb_va, mandiri_bill, echannel), as well as indomaret, alfamart, akulaku, kredivo, gci, danamon_online.

Changes are saved automatically.

Set Up Automatic Order Status Updates​

Go to Payments → Statuses, select the desired order storage, and link the preset payment statuses with the statuses of your order storage. Then, upon payment events from Midtrans, the order status will be updated automatically.

Custom Parameters for Payment API​

As with other providers, you can add custom parameters specific to the Midtrans API to the payment account (section "Custom Parameters for Payment API"). More details about this mechanism can be found in the "Accounts" section.