# API Payment Methods

Conoce la API que te permite aceptar una amplia gama de métodos de pago globales.

La API Payment Methods te permite aceptar diversos métodos de pago a través de una sola API. Un objeto [PaymentMethod](https://docs.stripe.com/api/payment_methods/object.md) contiene los datos del método para crear el pago. Con la API Payment Methods, puedes combinar un *PaymentMethod* (PaymentMethods represent your customer's payment instruments, used with the Payment Intents or Setup Intents APIs):

- Con un [PaymentIntent](https://docs.stripe.com/api/payment_intents.md) para aceptar un pago
- Con un [SetupIntent](https://docs.stripe.com/api/setup_intents.md) y un *Customer* (Customer objects represent customers of your business. They let you reuse payment methods and give you the ability to track multiple payments) para guardar los datos de pago para más tarde

## Métodos de pago aceptados

Para determinar qué método de pago usar en una región determinada, consulta la [guía de métodos de pago](https://stripe.com/payments/payment-methods-guide).

La guía incluye los métodos de pago disponibles para diferentes regiones, una descripción detallada de las características de cada método de pago y las [regiones geográficas](https://stripe.com/payments/payment-methods-guide#payment-methods-fact-sheets) en las que son más relevantes. Puedes habilitar cualquier método de pago disponible en el [Dashboard](https://dashboard.stripe.com). La activación suele ser instantánea y no requiere contratos adicionales.

## Acciones del cliente

Algunos métodos de pago exigen que el cliente cumpla pasos adicionales para completar el pago. El parámetro `next_action` del objeto PaymentIntent especifica el tipo de acción del cliente.

Estas son algunas de las acciones más frecuentes que deben realizar:

- Redirigirse al servicio en línea de su banco para autenticar y aprobar el pago.
- Verificar la titularidad de la cuenta por medio de un código único que publicas en la API de Stripe (por ejemplo, microdepósitos).
- Enviar fondos (por ejemplo, en caso de transferencias bancarias) mediante el servicio en línea del banco.

No todos los métodos de pago exigen que el cliente realice acciones adicionales. Por ejemplo, los pagos con tarjeta (excepto con 3D Secure) no necesitan una autenticación adicional fuera de la recopilación de los datos de tarjeta.

> Para los métodos de pago que requieren acción del cliente, configura [puntos de conexión de webhook](https://docs.stripe.com/payments/payment-methods.md#webhooks) para recibir notificaciones sobre si un pago se realizó correctamente o no.

## Notificación inmediata o diferida del pago efectuado con éxito

Algunos métodos de pago reflejan de inmediato el estado del pago cuando se efectúa una transacción (por ejemplo, los pagos con tarjeta). Otros, como los débitos ACH, en cambio, tienen un retraso. Cuando el estado del pago se refleja de inmediato, el estado del PaymentIntent cambia a `succeeded` o a `requires_payment_method`. El estado `succeeded` garantiza que recibirás los fondos del cliente.

Los métodos de pago con notificación diferida no pueden garantizar el pago durante la espera. El estado del objeto PaymentIntent será `processing` hasta que el estado del pago indique si se confirmó o falló. Durante ese plazo, es habitual que las empresas muestren que el pedido está *pendiente* y que recién lo cumplan cuando se concreta el pago.

> ​​Para los métodos de pago con notificación diferida, configura [puntos de conexión de webhook](https://docs.stripe.com/payments/payment-methods.md#webhooks) para recibir notificaciones sobre si un pago se realizó correctamente o no.

## De un solo uso o reutilizables

Puedes reutilizar ciertos métodos de pago (por ejemplo, tarjetas o débitos bancarios) para pagos adicionales sin tener que autorizar y recopilar de nuevo los datos de pago.

Siempre debes configurar métodos de pago reutilizables para usarlos en el futuro a fin de reducir la posibilidad de que se produzcan rechazos en el futuro e inconvenientes en los pagos, (como el [requerimiento de autenticación](https://docs.stripe.com/strong-customer-authentication.md)). Los métodos de pago reutilizables se pueden [configurar para su uso futuro cuando se acepte un pago](https://docs.stripe.com/payments/save-during-payment.md) o [configurar para su uso futuro sin aceptar un pago](https://docs.stripe.com/payments/save-and-reuse.md).

Los métodos de pago de un solo uso (por ejemplo, algunos tipos de transferencias bancarias) no se pueden asociar a clientes porque se consumen luego del intento de pago.

## Usa webhooks para hacer un seguimiento del estado de los pagos

Configura webhooks mediante la creación de un [punto de conexión de webhook u otro tipo de destino](https://docs.stripe.com/event-destinations.md) de evento para los métodos de pago que requieren la acción del cliente o cuando la notificación del pago se retrasa. Stripe envía los siguientes eventos cuando se actualiza el estado `PaymentIntent`:

| Evento                          | Descripción                                                                                                                                                                              | Próximos pasos                                                                          |
| ------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------- |
| `payment_intent.processing`     | El pago del cliente se envió a Stripe con éxito. Solo se aplica a métodos de pago con [notificación diferida](https://docs.stripe.com/payments/payment-methods.md#payment-notification). | Espera hasta saber si el pago iniciado se efectuó con éxito o no.                       |
| `payment_intent.succeeded`      | El pago se efectuó con éxito.                                                                                                                                                            | Entrega los productos o servicios comprados.                                            |
| `payment_intent.payment_failed` | Error en el pago.                                                                                                                                                                        | Envía un correo electrónico o una notificación push para solicitar otro método de pago. |

En lugar de configurar un destino de evento, también puedes usar las siguientes opciones:

- Rastrea manualmente el estado de los pagos en el Dashboard de Stripe, si tu empresa acepta pocos pedidos con métodos de pago con notificación diferida. El Dashboard te permite [ver todos tus pagos en Stripe](https://dashboard.stripe.com/test/payments), enviar recibos por correo electrónico, administrar transferencias o reintentar pagos fallidos.
- Usa el sondeo (por ejemplo, al recuperar repetidamente un PaymentIntent para comprobar su estado). Ten en cuenta que el sondeo es mucho menos confiable y puede no funcionar a escala. Stripe aplica una limitación de frecuencia a las solicitudes de API, así que ten cuidado si usas el sondeo.
- Usa una aplicación de socio para gestionar eventos comerciales comunes, como la [automatización](https://stripe.partners/?f_category=automation) o el [marketing y ventas](https://stripe.partners/?f_category=marketing-and-sales), al integrar una aplicación de socio.

## El objeto PaymentMethod

Un PaymentMethod contiene detalles del método de pago reutilizable para crear pagos (por ejemplo, fecha de vencimiento de la tarjeta o dirección de pagos); no incluye información específica de la transacción (por ejemplo, importe, moneda, etc.). Un PaymentMethod se adjunta a un PaymentIntent para representar los [estados del ciclo de vida de un pago](https://docs.stripe.com/payments/paymentintents/lifecycle.md). Cada PaymentMethod tiene un [atributo type](https://docs.stripe.com/api/payment_methods/object.md#payment_method_object-type) (por ejemplo, `"type": "sepa_debit"` ) y otro hash cuyo nombre coincide con el atributo type y contiene información específica del tipo PaymentMethod (por ejemplo, `"sepa_debit":{}`). Ejemplo de un objeto PaymentMethod `sepa_debit`:

```json
{
  "id": "pm_123456789",
  "object": "payment_method",
  "billing_details": {
    "address": {...},
    "email": "jenny@example.com",
    "name": "Jenny Rosen",
    "phone": "+335555555555"
  },"sepa_debit": {
    "bank_code": "37040044",
    "branch_code": "94832",
    "country": "FR",
    "fingerprint": "ygEJfUjzWMGyWnZg",
    "last4": "3000"
  },
  "type": "sepa_debit",
  (...)
}
```

> Para gestionar la información de pago confidencial en modo seguro y manejar las acciones de los clientes automáticamente, Stripe recomienda crear métodos de pago con [Stripe.js](https://docs.stripe.com/js.md#stripe-create-payment-method).

## See also

- [Guía de métodos de pago](https://stripe.com/payments/payment-methods-guide)
- [Referencia de la API Payment Methods](https://docs.stripe.com/api/payment_methods.md)