Skip to main content
POST
POST /payment-link/{id}/cancel desactiva un enlace active; su estado pasa a cancelled y la página alojada deja de aceptar pagos.
  • Cancelar un enlace que ya está cancelled no hace nada y devuelve el enlace.
  • Un enlace que ya está used devuelve 409: no se puede cancelar. Los pagos ya recibidos nunca se ven afectados; para devolver el dinero, reembolsa el pago.

​
Ejemplo

Autorizaciones

​
Authorization
string
header
requerido

Your secret API key: Bearer prv_production_xxx (production) or Bearer prv_sandbox_xxx (sandbox).

Parámetros de ruta

​
id
string<uuid>
requerido

The payment link id.

Cuerpo

application/json
​
merchantCode
string

Your merchant account identifier. Required if the key maps to more than one merchant account.

Respuesta

The cancelled link (cancelling an already-cancelled link is a no-op)

​
id
string<uuid>
​
url
string<uri>

The hosted checkout URL to share with the payer.

​
type
enum<string>
Opciones disponibles:
one-time,
subscription
​
status
enum<string>

used once a single-use link takes its first successful payment, or a reusable link reaches maxUses.

Opciones disponibles:
active,
used,
expired,
cancelled
​
amountMode
enum<string>
Opciones disponibles:
fixed,
customer_entered
​
amount
object

Absent on subscription links. For customer_entered links only currency and exponent are set.

​
amountMin
integer<int64>

Minimum payer-entered amount, minor units.

​
amountMax
integer<int64>

Maximum payer-entered amount, minor units.

​
subscriptionPlanId
integer<int64>
​
checkoutConfigId
string<uuid>
​
title
string
​
description
string
​
reference
string
​
customerEmail
string
​
customerName
string
​
returnUrl
string<uri>
​
saveCardEnabled
boolean
​
reusable
boolean
​
maxUses
integer
​
usesCount
integer

Number of successful payments taken through this link.

​
environment
enum<string>
Opciones disponibles:
production,
sandbox
​
expiresAt
string<date-time>
​
usedAt
string<date-time>
​
createdAt
string<date-time>