[IMPORTANT] New SEFAZ NT 2025.001 Payment Parameters Required in XML

资料正文

§1 [IMPORTANT] New SEFAZ NT 2025.001 Payment Parameters Required in XML

Dear Developers,

According to SEFAZ NT 2025.001, starting September 1, 2025, the government will validate the following payment-related fields in the invoice XML for Credit Card, Debit Card, and Pix payments:

CNPJ of the payment processor;
Card brand (not required for Pix);
Payment authorization code;
Individual amounts for each payment method when multiple payment methods are used.

To comply with this requirement, starting August 27, 2025, Shopee will provide the following response parameters in the v2.order.get_order_detail for orders with status READY_TO_SHIP:

Name	Type	Sample	Description
payment_info	object[]	/	List of payment information
>>payment_method	string	Debit Card	Payment method used in the order.
>>payment_processor_register	string	38.372.267/0001-82	CNPJ of the payment processor handling the transaction.
>>card_brand	string	VISA	Card brand for credit or debit transaction. Empty for Pix payments.
>>transaction_id	string	951679	Payment authorization code generated by the bank or payment processor to validate the transaction.

Sample Response:

We recommend developers complete the necessary adjustments before the required date to ensure smooth XML issuance and complete payment information.

尊敬的开发者，

根据巴西 SEFAZ 发布的 NT 2025.001 要求，自 2025 年 9 月 1 日起，政府将在发票 XML 中对信用卡、借记卡和 Pix 支付的以下字段进行校验：

收单机构 CNPJ；
卡品牌 (Pix 不需要)；
支付授权码；
当使用多种支付方式时，每种支付方式对应的单独金额；

为满足该要求，自 2025 年 8 月 27 日起，Shopee 将在 v2.order.get_order_detail 中，为 READY_TO_SHIP 状态的订单新增以下响应参数：

Name	Type	Sample	Description
payment_info	object[]	/	支付信息列表
>>payment_method	string	Debit Card	订单使用的支付方式
>>payment_processor_register	string	38.372.267/0001-82	处理支付交易的收单机构 CNPJ
>>card_brand	string	VISA	信用卡或借记卡的品牌，如果是 Pix 支付，则为空
>>transaction_id	string	951679	银行或支付机构生成的支付授权码，用于验证交易有效性

响应示例：

请各位开发者在规定日期前完成相关调整，以确保 XML 开票顺利且信息完整。