Create Checkout

​Information

​Request Details

​Headers Structure

​Body Structure

​Request Example

{
    "amount": 50000,
    "ewallet_vendor": "EWALLET_SHOPEEPAY",
    "customer_name": "John Doe",
    "customer_email": "john@example.com",
    "customer_phone": "081234567890",
    "merchant_redirect_url": "https://yoursite.com/payment/callback"
}

cURL Example:

curl -X POST "https://api.singapay.id/api/v1.0/ewallet-native/01K8AESCCKYSD98Z3P9RSDA36W/create-checkout" \
  -H "X-PARTNER-ID: b3ed7d4b-a96c-6c08-b3c7-12c3124242d9" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9..." \
  -d '{
    "amount": 50000,
    "ewallet_vendor": "EWALLET_SHOPEEPAY",
    "customer_name": "John Doe",
    "customer_email": "john@example.com",
    "customer_phone": "081234567890",
    "merchant_redirect_url": "https://yoursite.com/payment/callback"
  }'

​Request Example with Custom Expiration

{
    "amount": 100000,
    "ewallet_vendor": "EWALLET_DANA",
    "expired_at": "2026-02-10T15:00:00+07:00",
    "customer_name": "Jane Smith",
    "customer_phone": "089876543210",
    "merchant_redirect_url": "https://yoursite.com/payment/callback"
}

​Response Details

​Response Structure

​Response Example

{
    "status": 200,
    "success": true,
    "data": {
        "id": 42,
        "account_id": 15,
        "reff_no": "EWT01JKABCDEF123456789",
        "status": "open",
        "status_computed": "open",
        "is_expired": false,
        "ewallet_vendor": "EWALLET_SHOPEEPAY",
        "amount": 50000.0,
        "total_amount": 50000.0,
        "merchant_fee": 1000.0,
        "net_amount": 49000.0,
        "checkout_url": "https://wsa.wallet.airpay.co.id/universal-link/wallet/pay?deep_and_deferred=1&txn_token=abc123",
        "checkout_url_app": "shopeeid://main?type=transfer&token=abc123",
        "vendor_reference_no": "SP20260209ABC123",
        "merchant_redirect_url": "https://yoursite.com/payment/callback",
        "additional_info": {
            "web_redirect_url": "https://wsa.wallet.airpay.co.id/universal-link/wallet/pay?deep_and_deferred=1&txn_token=abc123",
            "app_redirect_url": "shopeeid://main?type=transfer&token=abc123",
            "shopeepay_reference_no": "SP20260209ABC123",
            "response_code": "2005400"
        },
        "customer_name": "John Doe",
        "customer_email": "john@example.com",
        "customer_phone": "081234567890",
        "balance_after": null,
        "has_recon": false,
        "recon_at": null,
        "recon_by": null,
        "has_settle": false,
        "settle_at": null,
        "settle_by": null,
        "has_settle_request": false,
        "settle_request_at": null,
        "settle_request_by": null,
        "payment_channel": null,
        "payment_vendor_code": "EWALLET_SHOPEEPAY",
        "is_auto_settle": false,
        "settlement_method": null,
        "processed_timestamp": null,
        "expired_at": "2026-02-09T13:30:00+00:00",
        "created_at": "2026-02-09T13:00:00+00:00",
        "updated_at": "2026-02-09T13:00:00+00:00",
        "deleted_at": null,
        "events_count": 1
    }
}

{
    "status": 422,
    "success": false,
    "error": {
        "message": "The given data was invalid.",
        "errors": {
            "amount": ["Max amount is Rp. 2.000.000,-."],
            "ewallet_vendor": ["The selected ewallet vendor is invalid."]
        }
    }
}

---

​Important Notes

• Checkout URL: After creating a checkout, redirect the customer to the checkout_url (web) or checkout_url_app (app deep link) so they can authorize and complete the payment.
• Default Expiration: If expired_at is not provided, the checkout expires in 30 minutes.
• Amount Limits: The min/max amount depends on your merchant agreement. If exceeded, a validation error (422) is returned.
• Supported Vendors: Currently supports EWALLET_SHOPEEPAY and EWALLET_DANA.
• Fees: Fees (merchant_fee) are calculated and returned in the response. The net_amount is what you receive after fees.
• Status After Creation: The initial status is always open. Use Inquiry Status to check for payment completion, or wait for a webhook notification.
• One-Time Checkout: Each checkout URL is for a single payment. After the customer pays (or the link expires), you must create a new checkout for the next payment.
• Merchant Redirect URL: If you provide merchant_redirect_url, the customer will be redirected to your specified URL after completing or canceling the payment in the e-wallet app. If not provided, the customer is redirected to the default SingaPay payment status page.