General
This section contains frequently asked questions that apply to all products.
Webhook & Notifications
How long does it take to receive an asynchronous notification? If I query the transaction result after redirecting to the returnURL but before receiving the notification, how should I handle it?
You can call our payment GET API as a fallback mechanism when no asynchronous notification is received.
- The query returns the latest status, but not necessarily the final status.
- You need to check the
statusfield to determine if it is final.- If not final, wait for the asynchronous notification or query again later.
- All final statuses will trigger asynchronous notifications to your provided webhook.
What are the outbound IP addresses for asynchronous notifications?
Environment IP Address Normal 8.212.28.186 Disaster Recovery 18.140.151.69
API & Field Validation
How is the field length in the API specification defined? Why do I get Field xxx invalid format even if I didn't exceed the length limit?
The field length is calculated in bytes under UTF-8 encoding:
Character Type Bytes English letters / digits 1 byte each Chinese, Japanese, Korean 3-4 bytes each Do not simply count characters to determine length. For example, for a field like
goodsName, if it may exceed the limit, you can truncate to "first 30 characters + ...".
Is there any rate limiting when calling APIs?
Traffic Type Handling Normal business traffic No rate limiting. Resources are reviewed periodically. Short-term spikes (campaigns) Auto-scaling enabled. Please inform us in advance. Malicious requests Blocked by firewall without affecting normal business.
Why do I get Duplicated merchantTransID when calling capture or refund APIs?
- URL parameter
merchantTransID= the original payment'smerchantTransID- In the request body,
merchantTransInfo.merchantTransID= the new Capture/Refund order ID (different from the original payment order ID)
Payment & Orders
When the API returns "code":"B0007","message":"Unsupported currency XXX", how to resolve it?
This means the store and its configuration do not support the specified currency. This can only be resolved internally by EVONET. Please contact your integration manager or raise an internal support ticket.
When the API returns "code":"B0006","message":"Unsupported payment brand XXX", what should I do?
This usually means the specified payment method is not configured for the store.
- Add the reported payment method to the store configuration.
- It is recommended to check store payment method settings whenever this error occurs to avoid repeated issues.
When the API returns "code":"B0021","message":"3DS authentication failed", what does it mean?
This indicates that the user failed 3DS authentication.
When the API returns "code":"P0000","message":"Unknown PSP Code", what should I do?
This indicates an unmapped response code from the payment channel. This occurs when a new response code is received that has not yet been mapped in our system.
To investigate this specific issue:
- Check the order details in your platform
- Review the raw channel response via platform message query
When the API returns "code":"B0033","message":"Transaction rejected due to security reasons", what does it mean?
This indicates the transaction was rejected due to security reasons. Our risk control system performs dynamic assessment based on multiple factors including:
- Merchant profile
- Transaction scenario
- Payment method
- Transaction amount
There is no fixed limit applicable to all merchants. If you have specific business requirements, please contact your integration manager for further evaluation.
How to trigger a single payment method?
Pass the selected payment method's enum value to the
merchantOrderInfo.enabledPaymentMethodfield:{ "enabledPaymentMethod": ["Boost"] }Payment method names and logos should be displayed on your checkout page. You can download them here:
https://developer.evonetonline.com/docs/payment-methods-overview
How long before a pending payment order expires?
We do not proactively cancel or expire orders. Status will only be updated when notified by the channel or when queried.
For example, in card payment scenarios requiring 3DS, if the 3DS link is returned but the user does not access or successfully open it, the transaction will remain in
Processingstatus.
How to fill in allowAuthentication? Or how to control whether an international card transaction requires 3DS?
You can use the
allowAuthenticationparameter to control whether 3DS should be performed for an international card transaction.
Value Behavior true3DS will be performed for this transaction. false3DS may still be performed based on your merchant 3DS settings (Optional-Authentication or Must Authentication) and real-time risk control judgment. Sending
falsedoes not guarantee that 3DS will be skipped.
Refund
When the API returns "code":"B0032","message":"Refund not supported for this payment method", what does it mean?
This indicates that the payment method does not support refunds. Please check the payment method documentation or contact your integration manager for alternative solutions.
What are the refund limits and processing times?
Item Details Partial refund limit No limit - can refund until fully refunded Refund time limit System supports up to 365 days; different wallets may have different limits Processing time E-wallets: within 24 hours; Bank cards: 3-5 business days Refund fees Subject to contract terms
Chargebacks
How to respond to a chargeback notification email?
If you agree to refund: Simply reply to the email accepting the refund.
If you disagree: Reply to the original email with your dispute materials. The email attachment typically describes the chargeback details. If no attachment is present, reply to the email and our team will respond.
How long does it take to get chargeback dispute results?
From the time we submit to the card network:
Card Network Timeline Visa 30 days Mastercard 45 days If you do not receive a pre-arbitration notice within this period, the dispute is likely successful.
Updated 19 days ago
