APIs Charges x Payment Intents
Conheça as diferenças entre as duas principais APIs de pagamento da Stripe e quando usá-las.
Entenda as APIs de pagamento da Stripe
No momento, você pode aceitar pagamentos na Stripe de três maneiras:
- Stripe Checkout
- API Charges
- API Payment Intents
O Stripe Checkout é uma página de pagamentos pré-integrada. Você pode redirecionar seu cliente a essa página para fazer compras e assinaturas simples. Essa página oferece vários recursos, como Apple Pay, Google Pay, internacionalização e validação de formulários.
As APIs Charges e pagamento Intents permitem criar fluxos e experiências de pagamento personalizados.
A API Payment Intents é a API unificadora de todos os produtos e formas de pagamento da Stripe. A API Charges não está sendo desativada, mas os novos recursos são disponibilizados exclusivamente na API Payment Intents.
Veja na tabela a seguir a comparação completa entre os recursos:
| API Charges | API Payment Intents |
|---|---|
| Usada por empresas com clientes concentrados nos EUA/Canadá que desejam uma forma simples de aceitar cartões. | Obrigatória para empresas que aceitam várias formas de pagamento e cartões que exigem autenticação (por exemplo, para conformidade com a Autenticação Forte de Cliente na Europa). |
| Funciona com web, iOS e Android. | Funciona com web, iOS e Android. Também pode ser usada para aceitar pagamentos na loja com o Terminal. |
| Aceita cartões e todas as formas de pagamento na API Sources. | Aceita cartões, cartões que exigem 3DS, iDEAL, SEPA e várias outras formas de pagamento. |
| Não está pronta para SCA | Está pronta para SCA |
Migrar código que lê objetos Charge
Se você tiver um aplicativo com vários fluxos de pagamento e está migrando cada um deles da API Charges para a API API Payment Intents, primeiro atualize o código que lê o objeto Charge. Para ajudar com isso, o objeto Charge tem duas propriedades adicionais, payment_method_details e billing_details, que fornecem uma interface consistente para ler os detalhes da forma de pagamento usada para a cobrança.
Esses campos estão disponíveis em todas as versões da API e nos objetos Charge criados pelas APIs Charges e Payment Intents.
A tabela a seguir mostra as propriedades mais comuns de uma cobrança e como os mesmos dados podem ser acessados usando as propriedades adicionais: