Saltar al contenido principal
POST
Este endpoint te permite crear una nueva suscripción para un cliente. La creación de una suscripción implica asociar al cliente con un plan de suscripción específico y registrar su información de pago.

Autorizaciones

Authorization
string
header
requerido

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Encabezados

Authorization
string
requerido

Token de acceso Bearer para la autenticación. Este token se obtiene de los endpoints Get Access Token o Refresh Access Token.

Cuerpo

application/json
paymentMethod
object
requerido
externalId
string
requerido

Un identificador único generado por tu sistema para rastrear la transacción (alfanumérico y con guiones). Recomendamos usar UUID4 para garantizar su unicidad.

country
enum<string>
requerido

País del documento. ISO 3166-1 alfa-3.

Opciones disponibles:
COL,
MEX,
PER
amount
number
requerido

Importe de la transacción.

currency
enum<string>
requerido
Opciones disponibles:
COP,
MXN,
PEN,
USD
accountNumber
string
requerido

Número de cuenta de Localpayment.

conceptCode
enum<string>
requerido

Motivo del pago, código.

Opciones disponibles:
0001,
0002,
0003,
0004,
0005,
0006,
0007,
0008,
0009,
0010,
0011,
0012,
0013,
0014,
0015,
0016,
0017,
0018,
0019,
0020,
0021,
0022,
0023,
0024,
0025,
0026,
0027,
0028,
0029,
0030,
0031,
0032,
0033,
0034,
0035,
0036,
0037,
0038,
0039,
0040
payer
object
requerido

Información del pagador.

card
object
requerido

Datos de la tarjeta de débito del pagador.

type
enum<string>
requerido

Especifica la categoría de suscripción.

Opciones disponibles:
SOFTWARE,
STREAMING,
CONTENT,
PRODUCTS,
MEMBERSHIP
autoRecurring
object
requerido

Propiedades de suscripción

comment
string

Información adicional

exchangeRateToken
string

Token proporcionado por el servicio de cambio de divisas para utilizar un tipo de cambio acordado previamente.

intermediaries
array

Matriz de objetos "Parte". Representa a otras partes en la cadena de pago, ya que el usuario final no es tu cliente directo. Ten en cuenta la secuencia de la matriz: tu cliente debe ser el primer elemento, el cliente de tu cliente el segundo, y así sucesivamente, hasta que no haya más intermediarios.

device
object
metaData
string

Objeto no estructurado para registrar cualquier metadato que sea significativo para ti.

commercialData
object

Información adicional relacionada con los bienes o servicios comercializados.

merchant
object

Información del comerciante.

invoice
string

Referencia de la factura.

item
object

Lista de artículos vendidos.

shipments
object

Lista de direcciones de envío

beneficiary
object

Información del beneficiario de la cuenta.

retry
object

Opciones de reintento de payin.

discount
object

Opciones de descuento.

Respuesta

OK

subscriptionId
string

Identificador único para la suscripción.

status
status · object

Estado de la operación.

creationDate
string

Fecha y hora de creación de la suscripción. La marca de tiempo sigue el formato ISO 8601.

nextPaymentDate
string

Fecha y hora de vencimiento del próximo pago de la suscripción. La marca de tiempo sigue el formato ISO 8601.

payments
object[]

Conjunto de objetos que representan los pagos asociados a la suscripción.

Última modificación el 10 de noviembre de 2026