Create a new payment request for a reservation

Production

https://api.checkandplace.com

POST

/v1/reservation-payments

Possible error scenarios:

invalid_params (800): Missing required fields (calendar_id, customer_id, currency)

amount_is_invalid (822): Amount is missing, zero, or negative

payment_expiry_duration_is_not_suitable (821): Expiration time is zero or negative

payment_available (819): Calendar already has an existing payment request

feature_disabled_error (832): SimpraLink extension is not enabled for this store

Request

Authorization

API Key

Add parameter in header

CheckandPlace-Access-Token

Example:

CheckandPlace-Access-Token: ********************

Body Params application/json

Examples

Responses

🟢201

application/json

Payment request created successfully

Bodyapplication/json

🟠401

🟠422

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.checkandplace.com/v1/reservation-payments' \
--header 'CheckandPlace-Access-Token: <api-key>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "calendar_id": "550e8400-e29b-41d4-a716-446655440000",
    "customer_id": "550e8400-e29b-41d4-a716-446655440001",
    "amount": 150,
    "currency": "TRY",
    "phone_number": "905551234567",
    "email": "customer@example.com",
    "send_email": false,
    "send_sms": true,
    "sms_content": "Please complete your reservation payment",
    "note": "VIP customer - priority handling",
    "expiration_time": 4320,
    "language": "TR"
}'

Response Example

201 - Example 1

{
    "reservation_payment_id": "550e8400-e29b-41d4-a716-446655440000",
    "reservation_payment_url": "https://checkandplace.simpralink.com/payment/abc123"
}

Modified at 2026-05-06 13:06:45

Activate or deactivate a payment request

Update an existing payment request