Motivos de rechazo

GET https://api.fire.rest/api/v1/fire/external/payment-decline-reasons
x-api-key: <tu_api_key>

{
  "success": true,
  "data": {
    "groups": [
      {
        "code": "funds",
        "label": { "en": "Funds", "es": "Fondos", "pt": "Fundos" },
        "displayOrder": 1,
        "reasons": [
          {
            "code": "INSUFFICIENT_FUNDS",
            "groupCode": "funds",
            "label": {
              "en": "Insufficient funds",
              "es": "Fondos insuficientes",
              "pt": "Saldo insuficiente"
            },
            "displayOrder": 1
          }
        ]
      },
      {
        "code": "technical",
        "label": { "en": "Technical", "es": "Técnico", "pt": "Técnico" },
        "displayOrder": 4,
        "reasons": [
          {
            "code": "ISSUER_UNAVAILABLE",
            "groupCode": "technical",
            "label": {
              "en": "Issuer unavailable",
              "es": "Emisor no disponible",
              "pt": "Emissor indisponível"
            },
            "displayOrder": 1
          }
        ]
      }
    ]
  }
}

{
  "success": false,
  "error": "UNAUTHORIZED",
  "message": "Invalid or expired API key"
}

{
  "success": false,
  "error": "FORBIDDEN",
  "message": "API key does not have the required scope: orders:read"
}

GET

api

fire

external

payment-decline-reasons

GET https://api.fire.rest/api/v1/fire/external/payment-decline-reasons
x-api-key: <tu_api_key>

{
  "success": true,
  "data": {
    "groups": [
      {
        "code": "funds",
        "label": { "en": "Funds", "es": "Fondos", "pt": "Fundos" },
        "displayOrder": 1,
        "reasons": [
          {
            "code": "INSUFFICIENT_FUNDS",
            "groupCode": "funds",
            "label": {
              "en": "Insufficient funds",
              "es": "Fondos insuficientes",
              "pt": "Saldo insuficiente"
            },
            "displayOrder": 1
          }
        ]
      },
      {
        "code": "technical",
        "label": { "en": "Technical", "es": "Técnico", "pt": "Técnico" },
        "displayOrder": 4,
        "reasons": [
          {
            "code": "ISSUER_UNAVAILABLE",
            "groupCode": "technical",
            "label": {
              "en": "Issuer unavailable",
              "es": "Emisor no disponible",
              "pt": "Emissor indisponível"
            },
            "displayOrder": 1
          }
        ]
      }
    ]
  }
}

{
  "success": false,
  "error": "UNAUTHORIZED",
  "message": "Invalid or expired API key"
}

{
  "success": false,
  "error": "FORBIDDEN",
  "message": "API key does not have the required scope: orders:read"
}

Devuelve el catálogo con el que Fire clasifica los pagos rechazados que le enviás en Confirmar pago.

Cómo se usa

Tu adquirente (Rede, Cielo, Stone…) te devuelve su código cuando una tarjeta se rechaza: 51, insufficient_funds, NSF. Cada uno lo escribe a su manera. Este catálogo es el vocabulario de Fire. Vos hacés la traducción de tu lado, una sola vez, y en decline_reason mandás el código de Fire:

tu adquirente dice  "51"   →   vos mandás  "INSUFFICIENT_FUNDS"

Funciona igual que los motivos de cancelación: descargás el catálogo y mandás uno de sus códigos. Fire no guarda los códigos de cada adquirente — vos tenés la documentación de Rede o Cielo, y mantener el vocabulario de cada proveedor en cada país no sería sostenible.Por eso el endpoint tampoco cuelga de una orden: es el mismo para toda tu cuenta.

Autenticación

string

requerido

Tu API key de Fire con scope orders:read.

Petición

GET https://api.fire.rest/api/v1/fire/external/payment-decline-reasons
x-api-key: <tu_api_key>

Respuesta

Grupos ordenados, cada uno con sus motivos. Los grupos sin motivos activos no se devuelven.

campo	qué significa
`code`	el código de Fire. Es el que tenés que enviar en `decline_reason`
`label`	texto en `en`, `es` y `pt`

El catálogo trae código, etiqueta y grupo. Nada más. No te dice si conviene reintentar ni quién debería actuar: esa decisión es tuya y de tu adquirente, que son los que ven la transacción. Grupos disponibles: funds, card, security, technical, operational.

{
  "success": true,
  "data": {
    "groups": [
      {
        "code": "funds",
        "label": { "en": "Funds", "es": "Fondos", "pt": "Fundos" },
        "displayOrder": 1,
        "reasons": [
          {
            "code": "INSUFFICIENT_FUNDS",
            "groupCode": "funds",
            "label": {
              "en": "Insufficient funds",
              "es": "Fondos insuficientes",
              "pt": "Saldo insuficiente"
            },
            "displayOrder": 1
          }
        ]
      },
      {
        "code": "technical",
        "label": { "en": "Technical", "es": "Técnico", "pt": "Técnico" },
        "displayOrder": 4,
        "reasons": [
          {
            "code": "ISSUER_UNAVAILABLE",
            "groupCode": "technical",
            "label": {
              "en": "Issuer unavailable",
              "es": "Emisor no disponible",
              "pt": "Emissor indisponível"
            },
            "displayOrder": 1
          }
        ]
      }
    ]
  }
}

{
  "success": false,
  "error": "UNAUTHORIZED",
  "message": "Invalid or expired API key"
}

{
  "success": false,
  "error": "FORBIDDEN",
  "message": "API key does not have the required scope: orders:read"
}

Qué guarda Fire

Cuando enviás un pago rechazado, Fire busca ese código en el catálogo y guarda el grupo y el grupo junto con lo que mandaste:

"declineReason":     "DO_NOT_HONOR",   // lo que mandaste
"declineReasonCode": "DO_NOT_HONOR",   // encontrado en el catálogo
"declineGroup":      "security"

Se guarda al registrar y no se recalcula al consultar, así tus métricas históricas no cambian solas cuando el catálogo se amplía.

Un código que no está en el catálogo no hace fallar el cobro. Se guarda tal cual, sin grupo, y esos registros quedan fuera de cualquier agrupado por motivo.Confirmar pago te lo avisa en la respuesta con resolvedTo: null. Revisalo en tu primera integración: si tu mapeo tiene un código mal escrito, todos tus rechazos entran sin clasificar y nada falla.

API

APIs de partner

PayBridge

Motivos de rechazo

Cómo se usa

Autenticación

Petición

Respuesta

Qué guarda Fire

Relacionado

Confirmar pago

Obtener orden

​Cómo se usa

​Autenticación

​Petición

​Respuesta

​Qué guarda Fire

​Relacionado

Confirmar pago

Obtener orden

Cómo se usa

Autenticación

Petición

Respuesta

Qué guarda Fire

Relacionado