Saltar al contenido principal

TempLinkDetails

idintegerrequired

Identificador único del link temporal

Example: 123
namestringrequired

Nombre del link temporal

Example: Factura #1234
urlurirequired

URL completa de pago para compartir con tus clientes

Example: https://getbasilic.com/pay/abc123xyz
shortUrluri

URL corta de pago para compartir con tus clientes

Example: https://getbasilic.com/t/abc123xyz
amountdecimalrequired

Monto del pago

Example: 150
currencystringrequired

Código de moneda

Example: USD
statusstringrequired

Estado actual del link

Possible values: [active, paid, expired, cancelled]

Example: active
paymentLinkIdinteger

ID de la plantilla del link de pago

Example: 17
paymentLinkNamestring

Nombre de la plantilla del link de pago

Example: Plantilla estándar de factura
dueDatetimedate-time

Timestamp programado de expiración del link temporal

Example: 2025-01-03T10:00:00.000Z
formData object

Datos de formulario precargados

property name* FormValueObject
valuestringrequired

Valor real que se va a guardar

labelstringrequired

Etiqueta legible para mostrar

supportedPaymentsstring[]

Métodos de pago permitidos

Possible values: [crypto, bank_transfer, credit_card, argentine_bank]

merchantIdstringnullable

Tu ID de referencia interno

Example: ORDER_12345
redirectUrlurinullable

URL única de redirección usada tanto para éxito como para falla cuando está configurada.

Example: https://merchant.example/checkout/result
successUrlurinullable

URL de redirección usada después de completar un pago exitoso.

Example: https://merchant.example/checkout/success
failureUrlurinullable

URL de redirección usada después de un pago fallido.

Example: https://merchant.example/checkout/failure
metadata object

Metadata personalizada

property name*any

Metadata personalizada

Example: {"order_id":"12345"}
client objectnullable

Cliente vinculado a este link de pago temporal, cuando aplica.

iduuidrequired
Example: 4f0de7f2-7cd9-4ea2-bb82-f3118ddbe940
taxIdstringrequired
Example: 30712345678
namestringrequired
Example: Acme SA
paymentStatus object

Estado de los pagos cobrados para este link de pago temporal.

statusstringrequired

Estado de cobro para este link de pago temporal específico.

Possible values: [unpaid, partial, paid, overpaid]

Example: partial
requestedAmountdecimalrequired

Monto objetivo configurado en el link temporal.

Example: 150
paidAmountdecimalrequired

Monto cobrado a través de pagos completados para este link temporal.

Example: 75
remainingAmountdecimalrequired

Monto que todavía queda pendiente en este link temporal.

Example: 75
paymentCountintegerrequired

Cantidad total de intentos de pago vinculados a este link temporal.

Example: 2
completedPaymentCountintegerrequired

Cantidad de pagos completados vinculados a este link temporal.

Example: 1
currencystringrequired

Moneda del monto del link temporal.

Example: USD
createdAtdate-timerequired

Timestamp de creación

Example: 2025-01-01T10:00:00.000Z
expiresAtdate-timerequired

Timestamp de expiración

Example: 2025-01-03T10:00:00.000Z
paidAtdate-timenullable

Timestamp de finalización del pago

Example: 2025-01-01T12:30:00.000Z
cancelledAtdate-timenullable

Timestamp de cancelación

Example: null
TempLinkDetails
{
  "id": 123,
  "name": "Factura #1234",
  "url": "https://getbasilic.com/pay/abc123xyz",
  "shortUrl": "https://getbasilic.com/t/abc123xyz",
  "amount": 150,
  "currency": "USD",
  "status": "active",
  "paymentLinkId": 17,
  "paymentLinkName": "Plantilla estándar de factura",
  "dueDatetime": "2025-01-03T10:00:00.000Z",
  "formData": {},
  "supportedPayments": [
    "crypto"
  ],
  "merchantId": "ORDER_12345",
  "redirectUrl": "https://merchant.example/checkout/result",
  "successUrl": "https://merchant.example/checkout/success",
  "failureUrl": "https://merchant.example/checkout/failure",
  "metadata": {
    "order_id": "12345"
  },
  "client": {
    "id": "4f0de7f2-7cd9-4ea2-bb82-f3118ddbe940",
    "taxId": "30712345678",
    "name": "Acme SA"
  },
  "paymentStatus": {
    "status": "partial",
    "requestedAmount": 150,
    "paidAmount": 75,
    "remainingAmount": 75,
    "paymentCount": 2,
    "completedPaymentCount": 1,
    "currency": "USD"
  },
  "createdAt": "2025-01-01T10:00:00.000Z",
  "expiresAt": "2025-01-03T10:00:00.000Z",
  "paidAt": "2025-01-01T12:30:00.000Z",
  "cancelledAt": null
}