[BR] RECAP DE PAYMENTS! Relembre as últimas atualizações nas APIs de Pagamentos

Olá, desenvolvedores

Conforme comunicados publicados anteriormente na Shopee Open Platform, ocorreram mudanças na forma como as informações financeiras são apresentadas aos vendedores, as comissões e taxas de serviço passaram a ser disponibilizadas também em seus valores líquidos, refletindo os rebates aplicáveis ao pedido e, para melhor conciliação, essas mudanças foram refletidas via API Payments, envolvendo os endpoints: v2.payment.get_escrow_detail e v2.payment.get_escrow_detail_batch.

27/12/2025 – Global Announcement: Significant OpenAPI Updates of Product, Payment, Logistics

14/01/2026 – Mudanças importantes nos relatórios de Faturamento (Brasil)

Novos campos: net_commission_fee net_service_fee net_commission_fee_info_list net_service_fee_info_list seller_product_rebate

Portanto: As taxas brutas continuam disponíveis, mas os campos NET já representam o valor final (valores líquidos) efetivamente cobrado após os rebates aplicáveis.

Taxas Brutas: Representam os valores originalmente calculados pela plataforma. commission_fee service_fee

Rebates e Offsets: Representam os ajustes aplicados sobre as taxas. Essas informações podem ser consultadas no bloco seller_product_rebate, incluindo campos como: amount commission_fee_offset service_fee_offset

Taxas Líquidas (NET): Já representam os valores líquidos, efetivamente descontados do seller após a aplicação dos rebates. net_commission_fee net_service_fee

Outras adições anunciadas também foram:

- REMAINING VOUCHER 02/06/2026 – [IMPORTANTE] Novo campo remaining_voucher, API

Novo campo: remaining_voucher

- SMART VOUCHER

01/07/2026 – Adição do campo de Ads Smart Voucher em APIs de Pagamentos

Novo campo: ads_voucher_discount

Anúncios anteriores enviados sobre o tema:

1. [Importante] Atualizações na Open API: Novo campo “discount_pix”

2. [IMPORTANTE] Novo campo de faturamento pix_discount

3. [SEH] Tudo sobre Minha Renda

Recomendamos sempre considerar o response completo da API durante processos de conciliação financeira e seguirem a documentação oficial da Open Platform para maiores detalhes.

É de responsabilidade do desenvolvedor atenta-se as mudanças e atualizações dentro das documentações, bem como verificar os anúncios publicados pela Open Platform, que agora também estão disponíveis no console do desenvolvedor.

NOVIDADE: Central de Notificações no Console do Desenvolvedor & Assistente IA! ⭐

Atenciosamente, Shopee Open Platform BR