Getting Started

This API is used to make payment for booking. Make payment by sending a POST request to the endpoint /make-payment.

Base URL
https://staging-api.meetingroomz.com/aggregator/v1/
Description

Initiates a one-time payment using the provided card details. Your system collects card information securely and sends it to our API for processing.

Request Parameters

Field Name Description
api_key* Api key provided by admin
company_id* Company ID provided by admin
payment_ref_key* Payment reference key obtained from create booking api
platform_charges Platform Charges if applicable (number)
card_name* Card name
card_no* Card number
expiry* Expiry date of card (mm/YYYY)
cvc* Cvc number of card
address Street address
city City
state State
zip Zip number

Request Body: 

{
    "payment_ref_key": "i6x3....",
    "platform_charges": "10",
    "card_name": "Visa",
    "card_no": "424242......",
    "expiry": "10/2050",
    "cvc": "1234",
    "address": "Dummy",
    "city": "Dummy",
    "state": "Dummy",
    "zip": "123456" 
}

Response: 

{
  "success": true,
  "message": "Payment successful",
  "data": {
    "transaction_id": "txn_1ABCD1234XYZ",
    "status": "succeeded",
    "amount": 2500,
    "currency": "usd",
    "payment_method": "card",
    "card_last4": "4242"
  }
}

3D Secure (3DS) & 2D Secure (2DS) Flow

Depending on the card type and bank, transactions may require 3D Secure (3DS) authentication. Our system automatically handles 3DS challenges and provides a URL for redirection if needed.

3DS Required Response
{
  "success": false,
  "requires_action": true,
  "message": "3D Secure authentication required",
  "data": {
    "redirect_url": "https://api.yourdomain.com/3ds/redirect?pi=pi_12345_secret_abc"
  }
}

Your front-end should redirect the customer to the given redirect_url. After successful authentication, the payment will be automatically confirmed, and the webhook will notify you of the final status.

Testing

Use Our test card numbers to simulate different scenarios.

  • Successful payment: 4242 4242 4242 4242
  • 3DS required: 4000 0027 6000 3184
  • Card declined: 4000 0000 0000 9995