Use Case

Our APIs can be used to enable users to checkout from online stores and offer subscription services.

If our API is unable to meet your requirement, write to us. Our team is ready to explore solutions with you.

Checkout/Sales

Add a VISA/Mastercard payment option to your online store. Paydee’s SALES API offers Frictionless Flow (*new). Click any of the following options to see how these payment pages work.

Message Flow

Important flows for Checkout/Sales.

End Point	Information
/mercReq	The checkout page will be rendered by Paydee
/mpReq	Use this to customize the experience of your checkout page.

PreAuth

At times, the final amount may be undefined and unknown. One such use case is a tour package where travellers may easily exceed the base tour package amount. Merchants may pre-authorized (PREAUTH) the transaction with a pre-agreed amount plus typical additional service chages before completing the transaction with a Sales Complete (SALESCOMPL).

Message Flow

Important flows for PreAuth.

End Point	Information
/mercReq	The checkout page will be rendered by Paydee
/mpReq	Use this to customize the experience of your check out page.

MPI Key Req
Purch ID=MPI Req
Tx ID

MPI Req
/NEW/ Tx ID=MPI Key Req
/NEW/ Purch ID

MPI Req
Ori Tx ID=MPI Key Req
Purch ID

Split Payment

Paydee’s Split Payment API gives you the ability to split a single payment over a period of time or create a subscription-base service.

The API would firstly validate the card by attempting to charge RM1.00 (or another value) on it. Our API would attempt to validate the cardholder through 3DS flow. This amount usually reverts back to the cardholder unless you wish not to. We have all bases cover.

Flow Control Parameter

Important control parameters for Split Payment.

Message Flow

Important flows for Split Payment.

End Point	Information
/mercReq	The checkout page will be rendered by Paydee
/mpReq	Use this to customize the experience of your check out page.

MPI Key Req
Purch ID=MPI Req
Tx ID

MPI Req
/NEW/ Tx ID=MPI Key Req
/NEW/ Purch ID

For RECURR/INSTL

MPI Req
Ori Tx ID=MPI Key Req
Purch ID

You have to send in message with Original Transaction ID prefilled with the Transaction ID used to initiate the INITRECURR/INITINSTL/PRERECURR transaction.

Payment Reversal or Cancellation

Paydee allowed for a successful payment to be reversed or cancelled. The MPI supports VOID and REFUND method. A void transaction invalidates a payment before it's settled and finalized.

From the perspective of the payer and buyer, the transaction payment never happened - it won't appear on the merchant's or customer's financial statements, and you won't be charged payment processing fees for the transaction.

To ensure success, it's best to void a transaction as soon as possible, see the timetable below.

Void/Refund Reference Table

When a transaction has been settled, the fund would be sitting in the merchant account. The merchant would need to agree to refund the money back to the buyer. With the refunds, both the original transaction and the refund appear separately on the merchant's and customer's financial statements.

You should perform an INQ 30 minutes later, to inquire the status of the transaction. The field 'Payment Status' would show the reversal status of the transaction.

Void/Refund Reference Table