payment

Create a new payment

Initiate a new payment transaction with iPay88. Supports both initial payment (redirect to iPay88) and subsequent charge (using saved token).

post/payment/create

Request body

transactionType'RELOAD' | 'PURCHASE' | 'SUBSCRIPTION' | 'TOPUP' | 'OTHER' required

Transaction type

amountstring required

Payment amount (min 1.00)

currencystring required

Currency code

prodDescstring required

Product description

userNamestring required

User name

userEmailstring required

User email

userContactstring required

User contact number

responseURLstring

Frontend success/failure callback URL

backendURLstring

Backend callback URL for payment status updates

refNostring

Reference number (auto-generated if not provided, exactly 20 characters)

documentIDstring

Document ID

memberIDstring

Member ID

extraChargesstring

Extra charges

isTokenstring

Use saved token (1 = yes, 0 = no)

walletIDstring

Wallet ID

channelCodestring

Channel code

productIdstring

Product ID

remarkstring

Remark

creditTranDetailTypestring

Credit transaction detail type

memberIDDescstring

Member ID description

msisdnstring

MSISDN (phone number)

transferRefstring

Transfer reference

Example request

{
  "transactionType": "RELOAD",
  "amount": "50.00",
  "currency": "MYR",
  "prodDesc": "WOWlet Token Reload",
  "userName": "John Doe",
  "userEmail": "john.doe@example.com",
  "userContact": "+60123456789",
  "responseURL": "https://example.com/success",
  "backendURL": "https://example.com/callback",
  "refNo": "16twtopup34567890123",
  "documentID": "123456789012",
  "memberID": "TWE-123456",
  "extraCharges": "0.00",
  "isToken": "1",
  "walletID": "TWW-123456789012-1",
  "channelCode": "ip88",
  "productId": "PROD001",
  "remark": "Token Reload Transaction",
  "creditTranDetailType": "RELOAD",
  "memberIDDesc": "Member Description",
  "msisdn": "60123456789"
}

Response

Payment created successfully. For initial payment, redirectUrl and formData will be provided. For subsequent charge, payment status will be returned.

successboolean required

Success indicator

messagestring required

Message

Example response

{
  "success": true,
  "message": "Payment created successfully",
  "data": {
    "paymentId": 123,
    "refNo": "16twtopup34567890123",
    "status": "success",
    "amount": 50,
    "currency": "MYR",
    "transactionType": "RELOAD",
    "ipay88TransId": "IP88TXN123",
    "ipay88AuthCode": "AUTH123",
    "ipay88Status": "1",
    "cardDetails": {
      "last4": "1234",
      "cardType": "VISA",
      "cardHolderName": "JOHN DOE",
      "expiryMonth": "12",
      "expiryYear": "2025",
      "issuingBank": "MAYBANK",
      "issuingCountry": "MY"
    },
    "memberId": "TWE-123456",
    "walletId": "TWW-123456789012-1",
    "gkashStatus": "88 - Transferred",
    "gkashTransId": "M161-P0-999999",
    "gkashPaymentType": "Master Credit 0008"
  }
}

Changes

No recorded changes to this endpoint across all 1 revision of this API.