Registrar un evento de proveedor en dry-run
Registra payloads de solicitud, respuesta o webhook del proveedor para validación previa a producción.
X-Dry-Run: true.
Yuno ejecuta entonces un pipeline de validación automatizado que califica la calidad de la solicitud a la API pública frente al payload del proveedor: campos faltantes, diferencias de estructura, valores de enum incorrectos, metadata sin mapear y cualquier otra inconsistencia que haría que el pago real falle o se comporte de forma distinta una vez que salgas a producción.
Cómo funciona el par
- Tu integración hace su llamada normal al proveedor (por ejemplo Stripe, Adyen, dlocal).
- Tu integración también llama al endpoint correspondiente de la API pública de Yuno (por ejemplo
POST /v1/payments) con el encabezadoX-Dry-Run: true. Yuno acepta la solicitud, no la enruta a ningún proveedor y la almacena para compararla. - Tu integración llama a
POST /v1/dry-run/provider-eventscon el intercambio original con el proveedor (solicitud, respuesta, webhook) que acaba de realizar, correlacionado con el mismomerchant_reference. - Yuno empareja los dos registros por
merchant_reference+account_idy ejecuta el pipeline de validación. Los resultados están disponibles en el dashboard y medianteGET /v1/dry-run/provider-events/{id}(API de lectura, referencia aparte).
Cuándo usarlo
- Antes del lanzamiento: certifica tu integración con la API pública frente al comportamiento del proveedor que ya tienes funcionando.
- Migraciones de proveedor: verifica que un nuevo proveedor acepte los campos que Yuno reenvía antes de cambiar el tráfico.
- Pruebas de regresión: vuelve a ejecutar dry-runs en CI para detectar desviaciones cuando cambian tu integración o el contrato del proveedor.
merchant_reference. Consulta las reglas de correlación.POST /v1/payments acepta un encabezado de solicitud X-Dry-Run: true que le indica a Yuno que valide en lugar de enrutar. Ambas partes deben compartir el mismo merchant_reference para que la validación pueda emparejarlas.X-Idempotency-Key para reintentos seguros. La misma clave con el mismo payload devuelve la respuesta original; la misma clave con un payload distinto devuelve 409.Correlation
merchant_referencesiempre es obligatorio e identifica de forma única la orden de tu lado. Yuno lo usa para asociar el evento con un pago de forma asíncrona cuando no se envíapayment_id.payment_id, si se envía, se resuelve de inmediato. Si el id es desconocido para tu cuenta, la solicitud devuelve404 PAYMENT_NOT_FOUND.provider_id+payment_method_typeidentifican de forma opcional qué superficie de integración ejercita el dry-run (por ejemplostripe+CREDIT_CARD). Si se omiten, Yuno usa la información del pago asociado.
Encabezados
Cuerpo
Identificador del proveedor. Los valores permitidos están alineados con el catálogo de Yuno.
STRIPE, ADYEN, CYBERSOURCE, BRAINTREE, NMI, CHECKOUT, WORLDPAY, PAYPAL, EBANX, GLOBALPAYMENTS, NUVEI, CIELO, MPGS, PRISMA, FISERV, WORLDLINE, ANTOM, ORBITAL, GOCARDLESS, AUTHORIZE_NET, SONY, CITI, EPX, HPAY, PAYSTACK, PLAID, SAFERPAY, SIKA_HEALTH, VALIDIFI, WEPAY, CARD_CONNECT, GMO_PG, MONERIS, BLUESNAP, QUICK_GATEWAY, TWENTYFOUR_HOUR_FITNESS, MERCHANT_ESOLUTIONS, NETS, FAT_ZEBRA, WINDCAVE, CHASE_MOBILITY, HELIX, ANB, AMAZON_PAY, OPAYO, IP_PAYMENTS, KLARNA, BILLDESK, WELLS_FARGO, SAGEPAY, PLANET "STRIPE"
Método de pago que ejercita esta simulación. Mismo vocabulario que payment_method.type en POST /v1/payments.
, CARD, CREDIT_CARD, CREDIT_CARD_REFERENCE_TRANSACTION, DEBIT_CARD, EPX_TOKEN, TEST_CREDIT_CARD, UPC_TOKEN_TRANSACTION, APPLE_PAY, GOOGLE_PAY, PIX, PSE, OXXO, BOLETO, ALI_PAY, AMAZON_PAY, GCASH, IDEAL, KAKAO_PAY, KLARNA, MOMO_PAY, NAVER_PAY, OVO, PAYPAL, PAYPAL_CREDIT, PAYPAY, PAZE, TOSS_PAY, UPI, VENMO, ACH, BANK_TRANSFER, CRYPTO, CASH "CREDIT_CARD"
Respuesta
Simulación registrada
, CARD, CREDIT_CARD, CREDIT_CARD_REFERENCE_TRANSACTION, DEBIT_CARD, EPX_TOKEN, TEST_CREDIT_CARD, UPC_TOKEN_TRANSACTION, APPLE_PAY, GOOGLE_PAY, PIX, PSE, OXXO, BOLETO, ALI_PAY, AMAZON_PAY, GCASH, IDEAL, KAKAO_PAY, KLARNA, MOMO_PAY, NAVER_PAY, OVO, PAYPAL, PAYPAL_CREDIT, PAYPAY, PAZE, TOSS_PAY, UPI, VENMO, ACH, BANK_TRANSFER, CRYPTO, CASH "CARD"