Pagos rechazados

Los pagos pueden fallar por varios motivos, incluidos algunos que ayudan a prevenir las transacciones fraudulentas. Stripe trabaja para reducir las tasas de pagos rechazados en todos los métodos de pago admitidos. Trabajamos con emisores y redes para mejorar las tasas de aceptación, a menudo sin afectar a tu integración.

Hay tres motivos por los que puede fallar un pago:

• Pagos rechazados por el emisor
• Pagos bloqueados
• Llamadas a la API no válidas

Debes manejar cada tipo de error de pago de manera diferente. Para cada error, puedes usar el Dashboard o la API para revisar los detalles de un pago. Al usar la API, mira el resultado del objeto Charge. Este atributo indica el tipo de error de pago y proporciona información sobre su causa.

Stripe maneja los pagos rechazados de los métodos de pago que no son de tarjeta de manera similar a los pagos rechazados de las tarjetas. Stripe te envía un código de respuesta que incluye información sobre el pago rechazado, por ejemplo, si se debe a fondos insuficientes, a una tarjeta perdida o robada o a algún otro motivo.

Pagos rechazados del emisor

Cuando el emisor de la tarjeta del cliente recibe un cargo, sus sistemas y modelos automáticos deciden si lo autorizan. Estas herramientas analizan señales como los hábitos de compra, el saldo de la cuenta y los datos de la tarjeta (fecha de caducidad, información de la dirección y CVC).

Si el emisor de la tarjeta rechaza un pago, Stripe comparte contigo toda la información del pago rechazado que recibimos. Esta información está disponible en el Dashboard y a través de la API. Cuando los emisores proporcionan explicaciones específicas, como un número de tarjeta incorrecto o fondos insuficientes, estas explicaciones vuelven a Stripe a través de códigos de pagos rechazados.

Pagos bloqueados

Stripe Radar bloquea los pagos de alto riesgo, como aquellos en los que los valores de CVC o código postal no coinciden. Este producto automatizado de prevención del fraude evalúa cada pago, sin que tengas que realizar ninguna acción.

Un pago que Radar ha rechazado

Cuando Stripe bloquea un pago, obtiene la autorización inicial del emisor de la tarjeta, pero se abstiene de cargar la tarjeta. Esta precaución ayuda a prevenir posibles pagos fraudulentos que podrían dar lugar a disputas.

Para algunos tipos de tarjetas, los clientes pueden ver en su extracto bancario el importe del pago que ha autorizado el emisor de la tarjeta. Sin embargo, Stripe no ha cobrado este importe ni ha retirado los fondos. Por lo general, el emisor de la tarjeta eliminará esta autorización del extracto del cliente en unos días.

Si una regla que configuraste bloquea un pago que reconoces como legítimo, puedes eliminar el bloqueo ubicando el pago en el Dashboard y haciendo clic en Añadir a la lista de permitidos. Esta acción no vuelve a intentar procesar el pago. En su lugar, anula todas las demás reglas para que no bloqueen futuros intentos de pago que coincidan con el atributo de la lista.

Al utilizar la API, el outcome de un pago bloqueado indica el tipo de error y el motivo del error, junto con el nivel de riesgo evaluado.

...
outcome: {
  network_decline_code: null,
  network_advice_code: null,
  network_status: "not_sent_to_network",
  reason: "highest_risk_level",
  advice_code: "do_not_try_again",
  risk_level: "highest",
  seller_message: "Stripe blocked this charge as too risky.",
  type: "blocked"
},
...

Llamadas API no válidas

En la API, es posible que veas una llamada a la API no válida como la siguiente:

curl https://api.stripe.com/v1/charges \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d amount=2000 \
  -d currency=usd \
  -d source=tok_invalid \
  --data-urlencode description="Charge for jenny.rosen@example.com"

La llamada de API no válida genera una respuesta de error que podría verse de la siguiente manera:

{
  "error": {
    "code": "invalid_number",
    "doc_url": "https://docs.stripe.com/error-codes#invalid-number",
    "message": "Your card number is incorrect.",
    "param": "card[number]",
    "type": "card_error"
  }
}

El resultado de un pago rechazado incluye el tipo de error del pago y el motivo, basándose en el código de pagos rechazados del emisor de la tarjeta. El motivo puede contener información que no sea el código de respuesta del emisor, por ejemplo, si una evaluación de la regla Radar bloqueó el cargo.

...
outcome: {
  network_decline_code: "54",
  network_advice_code: "01",
  network_status: "declined_by_network",
  reason: "expired_card",
  advice_code: "do_not_try_again",
  risk_level: "normal",
  seller_message: "The bank returned the decline code `expired_card`.",
  type: "issuer_declined"
},
...

A medida que desarrolles tu integración con Stripe, pruébala continuamente para identificar posibles errores que puedan dar lugar a llamadas de API no válidas. Normalmente, las llamadas de API no válidas no hacen que aparezca un pago en tu Dashboard. Sin embargo, es posible que sí aparezca en algunos casos.

...
outcome: {
  network_decline_code: null,
  network_advice_code: null,
  network_status: "not_sent_to_network",
  type: "invalid"
},
...