Saltar al contenido principal
POST
Registrar destino
Agrega un host a la lista de destinos permitidos de tu cuenta. El proxy de reenvío solo envía datos de tarjetas a los hosts de esta lista; no existe un modo “cualquier host”. Consulta la guía de la lista de destinos permitidos para saber cómo funciona la coincidencia.
Agregar un destino es una acción sensibleRegistrar un host amplía los lugares a los que se pueden enviar tus tarjetas almacenadas. Restringe quién puede gestionar la lista de permitidos y revisa cualquier adición inesperada.

Autorizaciones

public-api-key
string
header
predeterminado:<Your public-api-key>
requerido
private-secret-key
string
header
predeterminado:<Your private-secret-key>
requerido

Cuerpo

application/json
hostname
string
requerido

El nombre de host público simple que se permite, sin esquema, puerto ni ruta (por ejemplo, api.example-processor.com). Se compara de forma exacta, sin distinguir mayúsculas de minúsculas.

Ejemplo:

"api.example-processor.com"

purpose
string

Una etiqueta opcional legible que describe por qué se permite este host. Se muestra cuando listas los destinos.

Ejemplo:

"Direct acquiring — Processor X"

account_id
string<uuid> | null

Opcional. Restringe este destino a una sola cuenta (un UUID). Omítelo (o envía null) para permitir el host en toda la organización.

Ejemplo:

null

Respuesta

El destino se registró.

id
string<uuid>

Identificador único del destino. Úsalo para eliminar el destino.

Ejemplo:

"d7e8f9a0-1234-4b5c-8d6e-7f8091a2b3c4"

account_id
string | null

La cuenta a la que está asociado este destino, o null cuando aplica a toda la organización.

Ejemplo:

null

hostname
string

El nombre de host registrado.

Ejemplo:

"api.example-processor.com"

status
enum<string>

Indica si el destino está activo. Solo los destinos ENABLED se usan en la ruta de reenvío.

Opciones disponibles:
ENABLED,
DISABLED
Ejemplo:

"ENABLED"

purpose
string

La etiqueta que proporcionaste al registrar el destino.

Ejemplo:

"Direct acquiring — Processor X"

created_at
string<date-time>

Cuándo se registró el destino.

Ejemplo:

"2026-07-09T13:05:36Z"

updated_at
string<date-time>

Cuándo se cambió el destino por última vez.

Ejemplo:

"2026-07-09T13:05:36Z"