---
title: "iPay88 response handler"
method: POST
path: "/payment/response/ipay88"
tags: ["payment"]
---

# iPay88 response handler

`POST /payment/response/ipay88`

Handles POST from iPay88 ResponseURL and redirects to frontend response page

## Request body

- IPay88CallbackDto
  - `MerchantCode` string, required — Merchant Code
  - `PaymentId` string, required — Payment ID
  - `RefNo` string, required — Reference Number (exactly 20 characters)
  - `Amount` string, required — Payment amount
  - `Currency` string, required — Currency
  - `Remark` string — Remark
  - `TransId` string, required — Transaction ID from iPay88
  - `AuthCode` string, required — Authorization Code
  - `Status` string, required — Payment Status (1=success, 0=failed)
  - `ErrDesc` string — Error description if failed
  - `Signature` string, required — Response signature
  - `TokenId` string — Token ID for subsequent charges
  - `CardDetails` string — Card details JSON
  - `MDR` string — MDR (Merchant Discount Rate) details
  - `CCNumber` string — Credit Card Number (masked)
  - `CCNo` string — Credit Card Number (masked) - alternative field
  - `CCName` string — Credit Card Name
  - `S_bankname` string — Bank name
  - `S_country` string — Country code
  - `TranDate` string — Transaction Date
  - `Optional` object — Optional JSON object with card details or MDR
  - `Xfield1` string — Custom field 1

## Other responses

- `302` — Redirects to frontend response page with payment parameters

---

[API](https://skmtc.dev/tonewow/apis/tonewow-database-api.md) · [All operations](https://skmtc.dev/tonewow/apis/tonewow-database-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/tonewow/tonewow-database-api/revisions/f36472974ad4/schema)