APIs Charges x Payment Intents
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 Payment 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 da API Sources. | Aceita cartões normais e os que usam 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ê tem um aplicativo com vários fluxos de pagamento e está migrando incrementalmente esses fluxos da API Charges para a API Payment Intents, precisa antes atualizar todo o código que lê o objeto Charge. Para ajudar essa alteração, o objeto Charge tem duas propriedades adicionais, payment_method_details e billing_details, que oferecem uma interface consistente para ler os dados da forma de pagamento usada na 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: