Topup Balance Online (Payment Gateway)

Get an online top-up URL for a loyalty member. Redirect the member to this URL to top up their loyalty credit via the standard payment gateway.

When to Use

▾

Use this endpoint when:

• Allowing members to top up their loyalty balance online
• Building a self-service top-up flow

How to Use

▾

Endpoint

POST/v3/loyalty/member/{memberId}/topup-online

POST /v3/loyalty/member/{memberId}/topup-online with the desired top-up amount. Redirect the member to the returned URL.

---

Request Parameters

▾

topUpAmountINTEGERrequired

Amount of credit to top up

Example: 10

redirectUrlSTRINGrequired

URL to redirect the member to after payment

Example: "https://revenuemonster.my"

Response Parameters

▾

itemOBJECT

Payment object

paymentUrlSTRING

Topup payment url

Example: "http://localhost:5001/v3/checkout?checkoutId=1612416816182682217"

codeSTRING

Successfully call this endpoint. If fail, will return error code object (Refer Appendix 1: Error Codes)

Example: "SUCCESS"