1. Payments
Pasarela Payment MyPay
  • Quick Start
  • Instalacion
  • Payments
    • Payments
      POST
    • Detalles de Transaccion
      POST
    • Extraccion Metadatos del BIN
      GET
    • Paginacion y Filtro
      GET
  • Payment Links
    • Crear payment link
      POST
    • Listar payment links
      GET
    • Estadísticas
      GET
    • Obtener payment link por ID
      GET
    • Cancelar payment link
      POST
    • Obtener payment link por token
      GET
  • Short URL
    • Redirect URL corta
      GET
  • Checkout
    • Página de checkout
      GET
    • Procesar pago
      POST
    • Estado del payment link
      GET
  1. Payments

Extraccion Metadatos del BIN

Entorno desarrollo
https://sandbox.mypaygateway.io
Entorno desarrollo
https://sandbox.mypaygateway.io
GET
/api/payments/binlookup/{bin}
Payments
Obtiene metadatos del BIN (marca, tipo, país, emisor) para enriquecer UX, validar reglas y apoyar antifraude.

Autenticación#

Requiere X-Api-Key válida.

Entradas#

BIN: cadena numérica con longitud mínima de 6 y hasta 8 dígitos (según proveedor).
Formato: solo dígitos; sin espacios ni separadores.

Salida#

Validez del BIN
Marca (p. ej., VISA/MC), tipo (crédito/débito), categoría (según proveedor),
País y emisor (nombre/indicativos si están disponibles).

Validaciones clave#

Longitud mínima (≥ 6) y correcto formato numérico.

Errores simulados#

400 Bad Request: longitud insuficiente o caracteres no numéricos.
404 Not Found: BIN no reconocido por el proveedor.
502 Bad Gateway: error/timeout del servicio externo de lookup.
*Notas: Los resultados pueden variar por proveedor y actualización de catálogos BIN; no los uses como sustituto de verificación bancaria.
No expongas estos datos si comprometen reglas de riesgo internas.*

Solicitud

Parámetros de ruta

Respuestas

🟢200OK
application/json
OK
Body

🟠400Bad Request
🔴500Internal Server Error
Solicitud Ejemplo de Solicitud
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://sandbox.mypaygateway.io/api/payments/binlookup/'
Respuesta Ejemplo de Respuesta
200 - Ejemplo 1
{
    "country": "string",
    "countrycode": "string",
    "cardbrand": "string",
    "ipcity": "string",
    "ipblocklists": [
        null
    ],
    "ipcountrycode3": "string",
    "iscommercial": true,
    "ipcountry": "string",
    "binnumber": "string",
    "issuer": "string",
    "issuerwebsite": "string",
    "ipregion": "string",
    "valid": true,
    "cardtype": "string",
    "isprepaid": true,
    "ipblocklisted": true,
    "cardcategory": "string",
    "issuerphone": "string",
    "currencycode": "string",
    "ipmatchesbin": true,
    "countrycode3": "string",
    "ipcountrycode": "string"
}
Modificado en 2025-11-17 21:29:08
Anterior
Detalles de Transaccion
Siguiente
Paginacion y Filtro
Built with