➕ Crear alias

POST /collector

Registra un nuevo alias de pago en el sistema utilizando la información proporcionada en el cuerpo de la solicitud.

Este endpoint valida los datos enviados y devuelve los detalles del alias de pago recién creado.

REQUEST

Headers

Atributo

Tipo

Requerido

Pattern

Descripción

X-API-Key

String

Sí

<API Key>

Podes consultar la sección (API Key) para más información.

Content-Type

String

Sí

application/json

El tipo MIME del contenido del cuerpo enviado. Por defecto JSON es Unicode UTF-8. No se debe configurar otro charset.

Body

Atributo

Tipo

Requerido

Descripción

external_reference

string

Sí

Referencia externa para identificar el alias en tus sistemas (alfanumérico, se aceptan "_", "-" y ".", de 1 a 100 caracteres).

name

String

Sí

Nombre del titular del alias (letras, números y espacios, de 1 a 255 caracteres).

id_number

String

No

Número de identificación del titular (solo dígitos, de 1 a 11 caracteres).

alias

String

No

Alias asignado (Alfanumerico, se acepta "." y "-" de 6 a 20 caracteres).

POST Nuevo alias

https://api-pct.qa.pagos360.com/v1/collector

Example Request

curl --location 'https://api-pct.qa.pagos360.com/v1/collector' \
--header 'X-API-Key: <API Key>' \
--header 'Content-Type: application/json' \
--data '{
"external_reference": "cli_8fj39dk20",
"name": "John Doe",
"id_number": "12345678910",
"alias": "john.doep360"
}'

📨 Respuesta

Una respuesta exitosa incluirá los siguiente atributos:

Atributo

Tipo

Descripción

id

integer

ID del alias creado.

id_number

string

ID Informado en la creacion del alias.

external_reference

string

Referencia externa enviada en la creacion del alias.

name

String

Nombre asignado al alias.

alias

string

Alias asignado.

cvu

string

CVU asignado al alias creado.

state

string

Estado del alias.

Atributo

Tipo

Descripción

id

integer

ID del Merchant.

email

string

Email asignado al Merchant.

name

string

Nombre del Merchant.

fantasy_name

string

Nombre de fantasia Merchant.

Example Response

{
"id": 2087,
"id_number": "12345678910",
"external_reference": "cli_8fj39d2k20",
"name": "John Doe",
"alias": "john.doe.p366",
"cvu": "0000302302000000021045",
"state": "ACTIVE",
"merchant":
{
"id": 1,
"email": "correo@pagos360.com",
"name": "Merchant name",
"fantasy_name": "Merchant Fantasy Name"
}
}