Vamos implementar novas atualizações no Adaptive Pricing para Checkout e Payment Links a partir de 8 de abril de 2025.

O que muda com essas atualizações?

Fizemos melhoras significativas no Adaptive Pricing:

• Sem tarifa adicional: você não receberá mais cobranças pelo uso do Adaptive Pricing. Em vez disso, seus clientes incorrerão em uma tarifa de conversão de 2% a 4% quando optarem por pagar na moeda local deles.
• Sem risco de câmbio em reembolsos: todos os reembolsos serão convertidos pela Stripe e devolvidos ao cliente na moeda de pagamento, sem custo adicional para você.
• Liquidação em uma só moeda: todas as transações serão liquidadas na sua moeda principal e sempre corresponderão ao preço que você definiu, independentemente da moeda de pagamento do cliente.

Como essas mudanças impactam minhas configurações atuais do Adaptive Pricing?

Essas atualizações no Adaptive Pricing serão um recurso integrado do Payment Links e não poderão mais ser desativadas. Ele será automaticamente ativado para o Checkout, exceto se você o tiver desativado anteriormente. Você pode optar por não usar o Adaptive Pricing para Checkout a qualquer momento.

O que devo fazer para me preparar para essas atualizações?

Revise sua integração para assegurar que qualquer destino de evento possa gerenciar objetos PaymentIntent com moedas locais. Com essas atualizações, a Sessão do Checkout e os objetos PaymentIntent subjacentes refletirão sua moeda de liquidação padrão e o valor para que você não precise mais usar o hash currency_conversion para determinar o que o seu cliente pagaria na sua moeda padrão.

Se um cliente pagar na moeda local dele, o evento checkout.session.completed conterá um hash presentment_details que inclui o presentment_amount e o presentment_currency. O valor e a moeda refletem o que seu cliente pagou na moeda local.

Como faço para testar essas atualizações antes de serem implementadas?

Para testar as atualizações para o Adaptive Pricing em modo de teste antes de 8 de abril de 2025, defina um cabeçalho beta na sua sessão do Checkout e/ou nas solicitações de criação do link de pagamento: Stripe-Version: adaptive_pricing_beta=v1. Quando testar os links de pagamento, você também precisa especificar payment_method_types. Para obter instruções sobre definir o cabeçalho Stripe-Version quando usar um SDK da Stripe, consulte o arquivo README no respectivo repositório GitHub. O cabeçalho beta só é aceito em modo de teste.

Saiba mais sobre como testar a apresentação de moeda local para Checkout e Payment Links usando o e-mail do cliente formatado conforme a localização.