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 status field 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?
EnvironmentIP Address
Normal8.212.28.186
Disaster Recovery18.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 TypeBytes
English letters / digits1 byte each
Chinese, Japanese, Korean3-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 TypeHandling
Normal business trafficNo rate limiting. Resources are reviewed periodically.
Short-term spikes (campaigns)Auto-scaling enabled. Please inform us in advance.
Malicious requestsBlocked by firewall without affecting normal business.
Why do I get Duplicated merchantTransID when calling capture or refund APIs?
  • URL parameter merchantTransID = the original payment's merchantTransID
  • 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.enabledPaymentMethod field:

{
  "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 Processing status.

How to fill in allowAuthentication? Or how to control whether an international card transaction requires 3DS?

You can use the allowAuthentication parameter to control whether 3DS should be performed for an international card transaction.

ValueBehavior
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 false does 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?
ItemDetails
Partial refund limitNo limit - can refund until fully refunded
Refund time limitSystem supports up to 365 days; different wallets may have different limits
Processing timeE-wallets: within 24 hours; Bank cards: 3-5 business days
Refund feesSubject 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 NetworkTimeline
Visa30 days
Mastercard45 days

If you do not receive a pre-arbitration notice within this period, the dispute is likely successful.