Skip to main content

​
Example Use Cases

Rooms Reservations
Rental Services
Pay-Per-Use Parking

​
API Required

  1. Create Purchase API
  2. Capture Payment API

​
Example JSON Payload

Alan rents a hotel room that costs RM 200.00, with an additional security deposit of RM 100.00.
  1. Create a reservation fee using the Purchases API
    - get checkout_url from the response body to be used as a payment link
    - get id from the response body to be used as a token
    Note: Alan’s reservation fee must be paid in order for the token to be usable.
{
  "client": {
    "email": "customer@example.com",
    "full_name": "Alan"
  },
  "purchase": {
    "products": [
      {
        "name": "Room fee",
        "price": 20000
      },
      {
        "name": "Security deposit",
        "price": 10000
      }
    ]
  },
  "skip_capture" : true,
  "brand_id": "<<Brand_id>>"
}
  1. Charge the funds using Capture Payment API
  • If the full security deposit is to be charged, capture the total amount:
{
  "amount" : 30000
}
  • If the security deposit is not being charged, capture only the room fee portion:
{
  "amount" : 20000
}

Note: Partial capture is possible as any remainder of uncharged funds will be released automatically

​
Skip Capture Parameter

When set to true, the skip_capture parameter authorizes the payment without capturing the funds, effectively holding the amount in the customer’s account without withdrawing it.

​
Testing Integration

It’s possible to test-drive all checkouts using a test Purchase. To test a successful payment, you can use the following card numbers:
  • 4444 3333 2222 1111 - non-3D Secure card
  • 5555 5555 5555 4444 - 3D Secure card
For both cards, please use:
  • any cardholder name
  • any expiry no earlier than the current month/year
  • CVC = 123
To test a failed payment, please change the CVC or expiration date. When using a 3D Secure enrolled card in S2S checkout, an incorrect CVC will trigger an authorization failure on the S2S callback step (after the customer returns from test ACS). Using a wrong expiry date emulates data validation failure and results in immediate error before that step.