Saltar al contenido principal
POST
Invocar el proxy de reenvío
Reenvía tu solicitud al destino indicado en el encabezado yuno-proxy-destination-url, reemplazando las expresiones {{vaulted_token.<TOKEN>.<field>}} dentro del entorno seguro de Yuno con los datos almacenados bajo el token almacenado: la tarjeta (PAN, vencimiento, nombre del titular), su token de red (DPAN y su vencimiento) y su ID de transacción de red (NTID). Para los destinos que requieren solicitudes firmadas con HMAC, envía yuno-proxy-auth + yuno-proxy-auth-secret-key y el proxy firma por ti el cuerpo ya resuelto. Consulta Destinos firmados para más detalles. Consulta la guía del Forward Proxy para una integración paso a paso.
BetaEl PCI Proxy está en beta y se habilita por organización. En producción, las solicitudes devuelven 403 PRODUCT_NOT_ENABLED hasta que tu organización sea activada; contacta a tu Key Account Manager (KAM). El sandbox está abierto para pruebas.
Solo del lado del servidorLas solicitudes al proxy desencriptan datos de tarjeta y solo deben hacerse desde tu backend. Nunca expongas tu private-secret-key en código del lado del cliente.
Se admiten todos los métodos GET, POST, PUT, PATCH y DELETE: el destino recibe el mismo método que usaste. Incluye la URL completa del destino, con su ruta y cualquier query string, en el encabezado yuno-proxy-destination-url; un query string en la propia solicitud a /pci-proxy/forward se rechaza. El host de destino debe estar en tu lista de destinos permitidos. Si eres un comercio certificado en PCI y necesitas los datos de tarjeta en bruto en lugar de una llamada de paso, usa en su lugar Retrieve Enrolled Payment Method by ID PCI Data.

Autorizaciones

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

Encabezados

yuno-proxy-destination-url
string
requerido

La URL completa del destino, incluidos su ruta y cualquier query string (por ejemplo https://api.example-processor.com/charges/ch_123/capture?expand=true). Debe ser un nombre de host HTTPS público en el puerto 443, y el host debe estar registrado en tu lista de destinos permitidos; las direcciones IP y las redes internas se rechazan. No debe contener expresiones {{vaulted_token...}} (los datos de la tarjeta nunca deben aparecer en una URL).

Ejemplo:

"https://api.example-processor.com/charges"

yuno-proxy-timeout
integer

Tiempo de espera del destino en segundos. Por defecto 30, máximo 120.

Rango requerido: 1 <= x <= 120
Ejemplo:

30

yuno-account-id
string

Ámbito de cuenta opcional. Restringe qué destinos de la lista de permitidos se aceptan para esta solicitud; no afecta la resolución de tokens (los tokens almacenados siempre tienen el ámbito de tu organización). Como todos los encabezados yuno-*, se elimina antes de reenviar y nunca llega al destino.

Ejemplo:

"acc_123"

yuno-proxy-auth
enum<string>

Esquema de firma para destinos que requieren firma HMAC de la solicitud sobre el cuerpo. El proxy calcula la firma sobre el cuerpo resuelto (después de sustituir las expresiones) e inyecta los encabezados de autenticación del destino; tu secreto de firma se usa en memoria y se descarta, no se almacena nada. Valor admitido: DLOCAL_HMAC (el proxy genera X-Date y calcula Authorization: V2-HMAC-SHA256, Signature: <hex> sobre X-Login + X-Date + cuerpo resuelto; tú envías X-Login, X-Trans-Key y X-Version como encabezados normales del destino). Un valor desconocido, o una solicitud DLOCAL_HMAC sin los encabezados X-Login o X-Trans-Key, se rechaza con 400 INVALID_REQUEST antes de contactar al destino.

Opciones disponibles:
DLOCAL_HMAC
Ejemplo:

"DLOCAL_HMAC"

yuno-proxy-auth-secret-key
string

Tu secreto de firma para esta solicitud (obligatorio cuando yuno-proxy-auth está presente). Como todos los encabezados yuno-*, se elimina antes de reenviar y se excluye de los registros.

Cuerpo

El cuerpo que espera la API de destino, con expresiones de token almacenado donde van los datos de la tarjeta. El proxy es transparente al contenido: reenvía tu cuerpo y Content-Type sin cambios y resuelve las expresiones {{vaulted_token.<TOKEN>.<field>}} en cualquier parte del cuerpo sin procesar, por lo que se admite cualquier tipo de contenido (JSON, form-encoded, XML). El objeto JSON de abajo es ilustrativo. Campos admitidos: number, expiration_month, expiration_year, holder_name, security_code; cuando la tarjeta tiene un network token, network_token_number (DPAN), network_token_expiration_month, network_token_expiration_year; y network_transaction_id (NTID: la referencia del esquema para la transacción original de la tarjeta, para transacciones iniciadas por el comercio). security_code se resuelve solo si la tarjeta se inscribió con un código de seguridad, y solo durante una ventana limitada después de la inscripción (consulta la guía del Forward Proxy); cuando no está disponible, la solicitud falla con EXPRESSION_RESOLUTION_FAILED. Los criptogramas son por transacción y no se resuelven: incluye el valor directamente en el cuerpo si tu destino lo requiere. Máximo 20 tokens distintos por solicitud; tamaño máximo del cuerpo 1 MB. Las expresiones también se resuelven en los valores de los encabezados. Todo el contenido que no es una expresión se reenvía sin tocar.

The body is of type object.

Respuesta

La respuesta del destino, devuelta sin cambios: estado, tipo de contenido y cuerpo. El cuerpo puede ser JSON, XML, texto o estar vacío, por lo que no se aplica ningún esquema.

Lo que haya devuelto el destino.