Sign in

v1

latestOpenAPI 3.1.02026-07-24558778.0 KB
Payments

Process credit card payment for a booking

Processes a credit card payment for the specified booking ID through the Adyen payment gateway.

This endpoint orchestrates a multi-step payment flow:

  1. Validates authentication and request structure
  2. Retrieves booking information from Transferz APIs
  3. Initiates payment in the Transferz system
  4. Prepares payment details with currency conversion
  5. Processes payment through Adyen
  6. Returns standardized success/error response

Supports 3D Secure authentication when browser information is provided.

post/bookings/{bookingId}/pay-by-creditcard

Path parameters

bookingIdstring required

The unique identifier of the booking to process payment for

Request body

originstring

Origin URL of the request (required for 3D Secure)

cardNumberstring required

Credit card number (PAN)

cardHolderNamestring required

Name of the card holder

expiryMonthinteger required

Card expiry month (1-12)

expiryYearinteger required

Card expiry year (must be in the future)

cvcstring required

Card verification code (CVV/CVC)

returnUrlstring required

URL to redirect the shopper after 3D Secure authentication

shopperEmailstring email required

Email address of the shopper

shopperIpstring required

IP address of the shopper

Example request

{
  "browserInfo": {
    "javaEnabled": true,
    "userAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36",
    "acceptHeader": "*/*",
    "language": "nl",
    "screenWidth": 1920,
    "screenHeight": 1200,
    "timeZoneOffset": 1,
    "colorDepth": 48
  },
  "origin": "https://www.example.com",
  "cardNumber": "5577000055770004",
  "cardHolderName": "John Doe",
  "expiryMonth": 3,
  "expiryYear": 2030,
  "cvc": "737",
  "returnUrl": "https://www.example.com/return",
  "shopperEmail": "john@example.com",
  "shopperIp": "192.168.1.1"
}

Response

Payment processed successfully

OR

Example response

{
  "result": "AUTHORISED"
}