Bi-SNAP is the recommended standard integration for MiniApp payments. Snap Checkout support is provided for merchants who already have an existing Snap Checkout integration and want to enable MiniApp Payments with minimal changes.

Minimum Required Changes

To enable MiniApp support using an existing Snap Checkout integration:

Add the gopay object
Include the provided pop_id
Ensure GoPay payment method is enabled

For MiniApp payments, pop_id is mandatory. Transactions without pop_id may not be routed correctly within the MiniApp flow.

The pop_id (Point of Purchase ID) will be shared via email in the integration document after requesting a new MiniApp creation.

Example cURL:

curl --location --request POST 'https://app.stg.midtrans.com/snap/v1/transactions' \
--header 'Content-Type: application/json' \
--header 'Authorization: Basic auth' \
--data '{
    "transaction_details": {
        "order_id": "test-123",
        "gross_amount": 100000
    },
    "gopay": {
        "pop_id": "<pop_id>"
    },
    "callbacks": {
        "finish": "https://www.google.com",
        "error": "https://www.facebook.com"
    }
}'

GoPay Object

"gopay": {
  "enable_callback": true,
  "callback_url": "http://gopay.com",
  "tokenization": true,
  "enforce_tokenization": true,
  "phone_number": "8123456789",
  "country_code": "62",
  "pop_id": "990407c8-7c2b-4998-8ef8-0bc67c0c6c55"
}

Parameter	Description
enable_callback Boolean (optional)	Enable redirect back to merchant from GoJek apps. Default: false
callback_url String (optional)	Determine where should customer be redirected from GoJek apps. It supports both HTTP and deeplink. Default: same value as finish url
tokenization Boolean (optional)	Determine whether GoPay Tokenization feature is enabled or not. Default: false
enforce_tokenization Boolean (optional)	When set to true, the fallback mechanism for GoPay tokenization is disabled. The transaction must be completed using the tokenization flow, unless multiple payment methods are enabled. Default: false
phone_number String (optional)	Determine the phone number that will be used on gopay tokenization. Default: null
country_code String (optional)	Determine the country code that will be used on gopay tokenization. Default: same value as finish url. Default: null
pop_id (optional)	For MiniApp payments, this parameter is mandatory to determine the Point of Purchase (POP).