Payment Gateway

Frequently Asked Questions​

Find answers to common questions about our services on this page.
Integration
❓How long does it take from the start of the cooperation process until transactions can go live?
On average, the cooperation and activation process until go-live takes around seven working days, depending on the completeness of the documents and the merchant integration readiness.
❓What should I prepare before starting the integration?
Before starting integration, make sure you have:
  • Identify the integration method you will use.
  • Obtained development credentials such as merchant code, merchant name, API Key, signature, and password.
  • Obtained access to the Sandbox Portal for monitoring and testing.
  • Access to the technical documentation according to the selected integration method.
  • Provide a callback endpoint URL that is publicly accessible via the internet.
❓ What is a callback endpoint?
A callback endpoint is an API URL provided on your system that allows Espay to:
  • Send an inquiry request to your system to retrieve transaction details.
  • Notify your system when the transaction status changes.
To ensure smooth communication, make sure the endpoint:
  • Accepts HTTPS requests using POST, or GET/DELETE (depending on the service).
  • Returns responses in the format specified in Espay technical documentation.
  • Must be accessible online, stable, and publicly available.
See the service details:
❓How do I ensure that my integration is working correctly?
Make sure you have followed the steps below:
  • Follow the technical documentation wholly and accurately.
  • Perform end-to-end testing to verify the full transaction flow.
  • Use the Espay Sandbox Portal for payment simulation.
  • Make sure all transactions are logged in your system for traceability.
❓What should I do after the integration is complete?
After completing the integration, you must go through two final steps before going live:
  • Espay UAT (User Acceptance Test)
    Based on test scenarios provided by the Espay team.
  • BI SNAP Document Completion (Bank Indonesia Open API Standard)
    You will need to complete:
    1. Dev Site BI
    2. Functional Testing
    3. SOP Guide & Matrix Explanation
    These documents ensure your compliance and understanding of SNAP regulations. See more details:
❓Can I use a local (localhost) callback endpoint for integration?
No. Espay sends callbacks over the internet, so your endpoint must:
  • Accept HTTPS POST requests (based on the service used).
  • Accessible online, stable, and publicly available.
  • Return a response that follows the documentation format.
Payment Simulation
❓How can I simulate Virtual Account or QRIS payments in the sandbox?
You can simulate Virtual Account or QRIS transactions through the Espay Sandbox Portal. Follow the simulation steps on the page:
❓How can I simulate payment cards (credit or debit cards) in the sandbox?
You can simulate card payments using dummy data (card number, CVV, and expiry date). Credential details can be viewed on the page:
❓Can I simulate e-wallet payments in the sandbox?
Currently, simulation for e-wallets only supports OVO.
❓How do I simulate OVO payments in the sandbox?
To simulate OVO payments:
  1. Choose OVO as the payment method.
  2. Enter a random mobile phone number on the payment screen.
Payments & Fees
❓How do I check which payment channels are available to me?
Use the Inquiry Merchant Info service. It returns a list of payment channels currently activated on your account. See the service details:
❓Can channel fees be charged to the customer?
Yes, you can pass the channel fees to your customers.
❓What is the difference between Static and Dynamic Virtual Accounts?
Category Static Virtual Account Dynamic Virtual Account
VA Number
Fixed
One-time use (unique per transaction)
Integration Method
Virtual Account (Send Invoice)
  • Virtual Account (Send Invoice)
  • Payment Host to Host
Required Services
Payment
  • Inquiry
  • Payment
See the service details
❓How can I resend a payment notification?
You can resend payment notifications in the following ways:
  1. Via Espay Support Team – Request to resend notification.
  2. Using Inquiry Status service – Set the isPayment: Y parameter to trigger the payment notification.
  3. Portal Espay (sandbox or production) – Use the “Update to success with notification” button”.
See the service details
Transaction Status
❓Why does a transaction status become "Suspect"?
The “Suspect” status occurs when Espay has not received confirmation of a successful transaction. Common causes include:
  • Failed callback (e.g., timeout or endpoint not reachable).
  • Timeout from the issuing bank.
Solutions:
  • Make sure your callback URL is correct and publicly accessible.
  • Ensure your system responds in the format expected by the technical documentation.
  • If the issue persists, please get in touch with Espay Support and include the transaction number to speed up the investigation.
See the service details
Settlement
❓Settlement times depend on your integration model:
Settlement times depend on your integration model:
  • Aggregator Model
    Funds are settled on H+3 working days after a successful transaction, between 14:00–17:00 WIB.
  • Direct Model
    Funds are settled in real time to your account after successful payment.
Managing Payment Channels
❓ Can I add new payment methods via the Espay Portal?
No, you cannot add payment methods independently via the Espay portal.
  • Sandbox
    Submit a request to the Espay Technical Team.
  • Production
    Update your PKS (Cooperation Agreement).
Security & Access
❓Can I whitelist more than one IP address?
Yes, you can whitelist multiple IP addresses.
  • Sandbox
    Use * (wildcard) to allow all IP (for testing purposes).
  • Production
    Send a request to Espay Support Team via email.
See the steps to add IP addresses in the Sandbox portal:
❓Does Espay support IP Whitelisting?
Yes, Espay supports IP Whitelisting. You can restrict access to only accept requests from Espay official IP addresses. See the list of Espay’s official IP and domain:
Scroll to Top