E.SUN Wallet

E.SUN Bank is one of the top three commercial banks in Taiwan, China, and its E.SUN Wallet has the most users among all commercial banks. E.SUN Wallet not only offers key digital wallet features but also allows users to link their credit cards. With around 3.47 million users and processing around 2.4 trillion TWD in monthly transactions, E.SUN Wallet provides a diverse range of services for local consumers, including online and offline payments, money transfers, investment and loans, food delivery, public transportation, ride-hailing, and utility bill payments.

Properties

The following table lists the product properties supported by E.SUN Wallet:

User experience

Note: The following payment flows on different terminals are reference only, and represent this payment method's flow on different terminal types. For supported merchants' terminal types, consult Antom Technical Support.
The following figure shows the journey of paying with E.SUN Wallet for the App terminal:
image.png
  1. The buyer selects E.SUN Wallet to pay at the merchant checkout page.
  2. The buyer is redirected to an external browser to open the E.SUN Wallet app.
  3. The buyer is redirected to the E.SUN Wallet app for authentication.
  4. The buyer confirms the order information and selects the funding source option for payment.
  5. The buyer completes the OTP.
  6. The buyer completes the payment and views the payment result.
  7. The buyer is automatically redirected back to the merchant result page.

Supported online payment integrations

Antom offers a range of integration options tailored to each payment method. Each payment method may support different online payment integration options, allowing for flexibility based on your business requirements. The table below provides detailed information about the specific integrations available for each payment method:

Integration considerations

The following section outlines integration considerations for various payment types, detailing customized integration solutions and payment method features.

Before payments

  • E.SUN Wallet currently does not support PC payments.
  • When making the first-time payment, the buyer needs to do the authentication binding on the merchant side. Specify the buyer ID via the referenceBuyerId field in the pay (One-time Payments) API to determine whether the buyer has been authenticated. Contact Antom Technical Support to obtain the length limit for this field.
  • TWD does not support decimal amounts, so the parameter value must be an integer multiple of 100. For example, when the parameter value is
    100
    , it represents 1 TWD.

Default timeout

You can use the paymentExpiryTime parameter value in the pay (One-time Payments) API request to define the timeout information. The default timeout is 14 minutes (including the first authentication process).

Request sample

The following is a code example in the payment request:
{
  "env": {
      "clientIp": "1.2.4.3", //Buyer IPv4 address. E.SUN Wallet is required
      "terminalType": "APP",
      "osType": "ANDROID"
  },
  "order": {
      "orderAmount": {
          "currency": "TWD",
          "value": "500"
      },
      "orderDescription": "Cappuccino #grande (Mika's coffee shop)",
      "referenceOrderId": "ORDER_2025010314112****",
      "buyer": {
          "referenceBuyerId": "555905142759" //Buyer ID. E.SUN Wallet is required
      },
      "goods": [
          {
              "goodsName": "test goods" //Goods name. E.SUN Wallet is required
          }
      ]
  },
  "paymentAmount": {
      "currency": "TWD",
      "value": "500"
  },
  "paymentMethod": {
      "paymentMethodType": "ESUN_WALLET"
  },
  "settlementStrategy": {
      "settlementCurrency": "USD"
  },
  "paymentNotifyUrl": "https://kademo.intlalipay.cn/payments/notifySuccess",
  "paymentRedirectUrl": "kademo://auth",
  "paymentRequestId": "PAYMENT_2025010314115****_AUTO",
  "paymentExpiryTime": "2027-03-19T09:48:50+0000",
  "productCode": "CASHIER_PAYMENT"
}