Invocar el Forward Proxy
Llama a cualquier API HTTPS de terceros con datos reales de tarjeta a través del entorno PCI DSS Nivel 1 de Yuno, referenciando las tarjetas almacenadas mediante vaulted_token.
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.
403 PRODUCT_NOT_ENABLED hasta que tu organización sea activada; contacta a tu Key Account Manager (KAM). El sandbox está abierto para pruebas.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
Encabezados
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).
"https://api.example-processor.com/charges"
Á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.
"acc_123"
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.
DLOCAL_HMAC "DLOCAL_HMAC"
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.