Obtener países

Devuelve los países donde tu cuenta puede cobrar depósitos en el entorno actual, con filtros opcionales por país o tipo de pago. Suele ser la primera llamada del flujo de integración.

GET/api/v1/pay-in/deposit-creation/countries

Autenticación	HTTP Basic (api_key:api_secret)
Mueve dinero	No

Parámetros de consulta

Todos opcionales.

Parámetro	Tipo	Descripción
countries[]	array de strings	Solo estos países. Códigos ISO de 3 letras (MEX, CHL…). Hasta 300 elementos.
payment_types[]	array de strings	Solo países que ofrecen estos tipos de pago (por ejemplo BANK_TRANSFER, CREDIT_CARD, VOUCHER, MOBILE_MONEY). Hasta 50 elementos. Los valores permitidos vienen del catálogo vigente.

Petición

curl -G https://sandbox-api.cashela.com/api/v1/pay-in/deposit-creation/countries \
  -u "$CASHELA_API_KEY:$CASHELA_API_SECRET" \
  -H "Accept: application/json" \
  --data-urlencode "countries[]=MEX" \
  --data-urlencode "payment_types[]=BANK_TRANSFER"

Respuesta 200

{
  "success": true,
  "data": [
    { "id": 142, "name": "Mexico", "iso_b": "MEX" }
  ],
  "message": "Countries retrieved successfully."
}

Campo	Descripción
data[].id	Identificador del país en Cashela.
data[].name	Nombre del país.
data[].iso_b	Código ISO de 3 letras. Envíalo como country en los demás endpoints Pay-In.

Nota

La lista depende de tu cuenta y del entorno, y puede cambiar. Sandbox y producción pueden devolver países distintos. No la fijes en tu código.

Errores

HTTP	Cuándo
401	Faltan credenciales o no son válidas. Ver Autenticación.
404	Ningún país coincide con tus filtros para tu cuenta (code: PARTNER_PAYIN_CATALOG_EMPTY).
422	Un filtro está mal formado, por ejemplo countries enviado como texto en vez de array ("The countries must be an array."), o un código de más de 3 letras.
429	Demasiadas peticiones. Respeta Retry-After.

Ver Errores para la lista completa.