Skip to content

Create Payment Link

This document describes how to create a payment link using the Autocore API. It consolidates all supported parameters into a single, flexible request body that can be adapted to different integration contexts (Bitrix24, Autocore WebApp, direct API usage).

Endpoint

POST https://[base_url]/v2/links/schedule/

Body Parameters

Core parameters

PARAMETER TYPE REQ. DESCRIPTION
hotel_id Integer Yes Hotel ID associated with the reservation. Refer to List hotels endpoint.
guest_name String Yes Guest full name.
email String Yes Guest email address.
country_code String No Guest country code in ISO 3166-1 alpha-2 format (e.g. CO).
phone String No Guest phone number.
available_hours Integer No Validity of the payment link in hours.
description String Yes Description shown on the payment link.
booking_dates String No Booking dates in format YYYY-MM-DD - YYYY-MM-DD.
source String No Source identifier of the payment link, if the account has multiple sources, the request must specify which one is being used. Contact [email protected] to obtain a valid value.
external_ref_id String No External reference ID for reconciliation or future lookups.
reservation_id String No Reference to the associated reservation, if available.
temp_webhook_url String No URL that will receive payment notifications (POST).
amount Integer Yes Total amount to be paid.
currency String Yes ISO currency code (e.g. COP).
installments Integer No Number of installments allowed, default 1.
allowed_payment_options Array No List of supported payment methods. Accepted values: nequi, daviplata, pse, credit_card, sinpe_movil, preloaded_balance, gift_cards.
redirect.success_url String No URL to redirect the user after a successful payment.
redirect.failure_url String No URL to redirect the user after a failed payment.
send_link_by_email Boolean No Whether Autocore should email the payment link URL to the guest (email). Defaults to true. Set to false when your integration will deliver the link by another channel (SMS, chatbot, PMS, etc.). Email is only sent in non-development environments.

Body Example

{
  "source": "Autocore WebApp",
  "hotel_id": 5,
  "guest_name": "Laura Pelaez",
  "email": "[email protected]",
  "country_code": "57",
  "phone": "3012104512",
  "amount": 120000,
  "booking_dates": "2026-01-27 - 2026-01-29",
  "description": "Reserva de 3 dias en Hotel ABC",
  "available_hours": 24,
  "reservation_id": "BK-00230690",
  "external_ref_id": "#45645",
  "allowed_payment_options":['nequi', 'daviplata', 'pse', 'credit_card'],
  "temp_webhook_url": "https://195.ngrok-free.app/payment",
  "send_link_by_email": true,
  "redirect": {
    "success_url": "https://app-dev.autocore.pro/main/link/success",
    "failure_url": "https://app-dev.autocore.pro/main/link/failure"
  }
}

Successful Response

Status code: 200

{
  "msg": "Link de pago generado exitosamente",
  "url": "https://app-dev.autocore.pro/payment/hotel_abc/25n0hcw84uio",
  "code": "25n0hcw84uio"
}

Error Responses

Status codes: 401, 403, 404

{
  "code": "Status code",
  "message": "Error description",
  "detail": "Error details"
}

Notes

  • All optional fields may be omitted if not required by the integration.
  • It is recommended to remove null values from the request body before sending it.
  • The same payload structure supports multiple sources (Autocore WebApp, custom integrations).
  • When send_link_by_email is false, the link is still created and returned in the response (url); only the automatic email to the guest is skipped.
  • The open payment link endpoint (POST /v2/links/open-schedule/) accepts the same send_link_by_email field in the request body.