Skip to main content
POST
/
bookings
/
{booking_id}
/
payments
Create a payment
curl --request POST \
  --url https://{your-subdomain}.neetocal.com/api/external/v1/bookings/{booking_id}/payments \
  --header 'Content-Type: application/json' \
  --header 'X-Api-Key: <x-api-key>' \
  --data '
{
  "payment": {
    "payment_provider": "upi",
    "identifier": "ext-123",
    "idempotency_key": "order-1"
  }
}
'
{
  "id": 123,
  "identifier": "your-external-payment-id",
  "status": "confirmation_pending",
  "amount": 100,
  "currency": "USD"
}
This endpoint is part of API v1, which is deprecated. Please use the v2 API instead.
Replace {your-subdomain} with your workspace’s subdomain.
Learn how to find your subdomain in Workspace subdomain.

Headers

​
X-Api-Key
string
required

Use the X-Api-Key header to provide your workspace API key. Refer to Authentication for more information.

Path Parameters

​
booking_id
string
required

Booking ID (numeric) or booking SID (short ID, up to 10 characters). You can get the booking SID from the Get booking details or List bookings response.

Example:

"8sqtzrs"

Body

application/json
​
payment
object
required

Response

OK - Payment created. Use the returned id when confirming the payment.

​
id
string<uuid>

Payment record ID. Use this in the confirm endpoint.

Example:

"f46c9ddf-221d-4238-afb2-280c1c6b3185"

​
identifier
string

Your external payment reference ID.

Example:

"your-external-payment-id"

​
status
enum<string>

Payment status.

Available options:
successful,
authorized,
declined,
pending,
requires_action,
requires_confirmation,
requires_payment_method,
confirmation_pending,
initiated,
rejected
Example:

"confirmation_pending"

​
amount
string

Payment amount.

Example:

"100.0"

​
currency
string

Currency code. Follows the ISO 4217 standard.

Example:

"USD"