Descargas y cambios

Descargas

Archivo	Qué es
Colección de Postman	Todas las peticiones Pay-In, listas para usar: países, tasas de cambio, métodos de pago, crear un depósito, consultar un depósito, reenviar una notificación y simulate de sandbox.
Entorno de Postman: sandbox	`base_url` = `https://sandbox-api.cashela.com`.
Entorno de Postman: producción	`base_url` = `https://production-api.cashela.com`.
Vectores de prueba de la firma	Casos para probar tu verificación de `X-Cashela-Signature`. Ver Webhooks.

Importa la colección y el entorno que necesites.
Rellena partner_key con tu clave API y partner_secret con tu secreto API del Portal de Desarrolladores. partner_secret es una variable de tipo secret: guárdala en tu valor local (current) y no la compartas ni la sincronices.
Ejecuta primero Get Available Payment Methods y usa uno de los códigos payment_method devueltos en Create Deposit.
Añade al cuerpo de Create Deposit los campos del pagador que exige el método elegido (required_fields), por ejemplo phone, document_key, document_number, con datos válidos para el país del depósito. Ver Datos del pagador y documentos.
Pon en reference la reference del depósito o tu external_identifier para ejecutar Get Transaction, Resend Callback y, en sandbox, Simulate Final Status.

La colección no incluye las peticiones de anulación y reembolso. Ver Anulaciones y reembolsos.

La API Pay-In se sirve bajo /api/v1/. Su versión de contrato (actualmente 3.5.0) cambia con independencia de la URL:

Las versiones menores (3.4 → 3.5) son aditivas: campos nuevos en las respuestas, códigos de error nuevos, comportamiento opcional nuevo. Construye tu integración para ignorar los campos que no conozca.
Las versiones mayores (2.x → 3.0) cambian algo que una integración existente puede notar.

En opciones de tarjeta que cobran en USD, amount / currency de la notificación son lo cobrado en USD (por ejemplo 5.00 USD), no la factura en moneda local. Los demás métodos no cambian.
GET /transactions/{reference} añade details.charged_amount y details.charged_currency: lo que realmente se cobró al cliente, la misma cifra que amount / currency de la notificación. details.invoice_* no cambia y sigue siendo la factura.
Documentado: en DECLINED y CANCELLED, los importes de la notificación son la cotización, no dinero que se movió.

Las anulaciones y reembolsos son solo para depósitos con tarjeta: los demás responden 422 PARTNER_PAYIN_REVERSAL_NOT_SUPPORTED y no se mueve nada.
Una anulación o un reembolso total devuelve todo el cargo a la tarjeta y Cashela conserva su comisión.

Cada opción de método de pago añade document_types (documentos aceptados con su formato) y required_fields (todos los campos que exige el método).

Cuando la red de pago rechaza un depósito por un campo del pagador, el 422 PARTNER_PAYIN_PROVIDER_REJECTED indica el campo en un provider_reason opcional.

Un rechazo por cumplimiento en Obtener métodos de pago lleva code: PARTNER_PAYIN_COMPLIANCE_BLOCKED.

Cambio incompatible: card.network es el código de red en minúsculas (visa, mastercard, discover, amex), o null si se desconoce, tanto en el depósito como en la notificación.

Cambio incompatible: el sobre de éxito es success, data, message. Se eliminaron dos claves internas que llevaba.

Nuevo estado final REVERSED para un depósito completado cuyo dinero se devolvió por completo.
Las respuestas 422 de validación llevan también success: false (status: false se mantiene como alias obsoleto).

Las opciones de método de pago pueden traer availability; un depósito con un método no disponible responde 422 PARTNER_PAYIN_ROUTE_UNAVAILABLE.

Nuevo endpoint solo de sandbox para llevar un depósito a un estado final: POST /sandbox/transactions/{reference}/simulate.

Host de producción confirmado: https://production-api.cashela.com.
Documentados la notificación firmada, el esquema de firma y los vectores de prueba.

La notificación añade card (network, last4) después de las claves existentes.

En algunas cuentas, las opciones de método de pago añaden data_standard y los errores de validación añaden field_errors[].