Send a payment link email

POST/v2/booking-orders/{id}/payment-link

Requires your API key in the X-API-Key header.

Emails the traveler a payment link for this order and flags the order as payment-link-sent. The request body is empty.

Deliberately allowed for EXPIRED orders: the 15-minute hold often elapses before a guest gets around to paying, and the payment link itself re-reserves the bookings when clicked, so the guest can recover from hold expiry.

The email is dispatched asynchronously after the request commits; a 200 means the send was queued, not that the email was delivered.

Requestbash
curl -X POST "https://api.turneo.co/v2/booking-orders/0f47ac10-b58c-4372-a567-0e02b2c3d479/payment-link" \
  -H "X-API-Key: <your-api-key>" \
  -H "Content-Type: application/json" \
  -d '{}'

Path parameters

  • idstring (uuid)required

    UUID of the booking order.

    Example:
    0f47ac10-b58c-4372-a567-0e02b2c3d479

Request bodyapplication/json

Example: empty
emptyjson
{}

Responses

200

Payment link email queued. Empty response body.

Errors

401

Missing or invalid X-API-Key header.

404

The resource does not exist or belongs to another partner (existence is not leaked across partners).

Error body
  • typestring

    Error class.

    Allowed values:
    validation_errorclient_errorserver_error
    Example:
    validation_error
  • errorsobject[]
    Child fields
    • codestring

      Machine-readable error code.

      Example:
      required
    • fieldstringnullable

      Offending field, or null/'general' for non-field errors.

      Example:
      startTime
    • messagestring

      Human-readable message.

      Example:
      This field is required.
Response 401json
{
  "type": "validation_error",
  "errors": [
    {
      "code": "required",
      "field": "startTime",
      "message": "This field is required."
    }
  ]
}