's Tutorials



80%

Standard Checkout

Standard Checkout

The user will be redirected on the url returned in the response.

The request will be send with POST method over HTTPS to the https://cunipay-sandbox.twpayz.com/walletServices/WalletCustomerService/checkoutPayment endpoint.

Sample Request

{
  "walletOwnerId": "199",
  "merchantEmail": "",
  "memberId": "191755",
  "toTelnocc": "",
  "toMobile": "",
  "merchantTransactionId": "FbzFXOd",
  "amount": "100.00",
  "fromCurrencyCode": "GBP",
  "consumerId": "STU897675",
  "consumerName": "Anjali Desai",
  "consumerCountry": "IND",
  "telnocc": "",
  "fromMobile": "",
  "customerEmail": "anjali.desai@gmail.com",
  "description": "Tuition Fee - Spring Semester 2025",
  "merchantRedirectUrl": "https://cunipay-sandbox.twpayz.com/",
  "notificationUrl": "https://cunipay-sandbox.twpayz.com/walletServices/WalletGatewayNotificationHandler",
  "ip": "192.168.0.1",
  "verificationHash": "c7a87c7f8df7ce75133ae9f4b0913ab2ca427ac8d43535d59381575e0db86617",
  "invoiceDetails": [
    {
      "ref": "454646",
      "description": "Exam",
      "date": "2026-04-13",
      "due_date": "2026-04-20",
      "original_amount": "1000",
      "balance": "500"
    }
  ]
}

Sample Response

{
    "responseCode": "1",
    "url": "https://cunipay-sandbox.twpayz.com/checkout/pay?token=yPPNiJ0MXiu3pzwIu6aGbr1YfuFCSGNu4U2mO3aStnU=&trackingId=317672",
    "status": "SUCCESS"
}

NOTE:

  • verificationHash - <api key> <walletOwnerId> <amount> <fromCurrencyCode> <merchantTransactionId> <merchantRedirectUrl>

How to generate verification Hash?

Verification Hash has to be calculated with following combination using SHA256 algorithm and need to be send along with the authentication parameters in each server-to-server request:
<api key> <walletOwnerId> <amount> <fromCurrencyCode> <merchantTransactionId> <merchantRedirectUrl>

Below is the description of fields used for generating hash:

  • apiKey <Secure Key as shared by TWPayz>
  • walletOwnerId <Wallet Owner ID as shared by TWPayz>
  • amount <Amount of transaction>
  • fromCurrencyCode <Currency of transaction>
  • merchantTransactionId <Unique transaction ID provided by merchant>
  • merchantRedirectUrl <Merchant Redirect url>
Standard Notification/ Callback

URL provided by the merchant where transaction notifications will be sent.

Checksum has to be calculated with following combination.

<paymentId>|<merchantTransactionId>|<amount>|<short status of transaction>|<secret key>

Example :

317672|FbzFXOd|100.00|Y|<merchant secret key>


{
  "amount": "100.00",
  "merchantTransactionId": "FbzFXOd",
  "currency": "GBP",
  "customer": {
    "email": "anjali.desai@gmail.com",
    "id": "STU897675"
  },
  "description": "Amount Transferred",
  "timestamp": "2026-04-13 20:59:33.0",
  "transactionStatus": "Y",
  "transactionType": "PURCHASE",
  "transactionSubType": "Card Transfer",
  "paymentReference": "INV-STU897675-FbzFXOd",
  "paymentId": "317672",
  "firstName": "Anjali",
  "lastName": "Desai",
  "descriptor": "pzintegration_GBP_1",
  "result": {
    "code": "1",
    "description": "Amount Transferred"
  },
  "card": {
    "bin": "444433",
    "lastFourDigits": "1111"
  },
  "remark": "Transaction succeeded",
  "tmpl_amount": "101.20",
  "tmpl_currency": "GBP",
  "checksum": "59314aa5698b58b6eb2747f9d74e53f0",
  "responseCode": 1,
  "status": "Success"
}

Sample Code