New Shopee's Openapi Announcement (ID: 1556)
Dear Developers
Please find below the OpenAPI updates released this time. These changes aim to enhance functionality, improve flexibility, and provide better integration support.
1. [BR] Return APIs Add Shipping Fee Responsibility and Reason Fields
- The v2.returns.get_return_list API will add the following response field:
| Field Name |
Type |
Description |
| shipping_fee_responsibility |
string |
Indicates the party responsible for the applicable shipping fees for the return before accounting for Shopee Easy Return Programme coverage. Possible values are Pending, Shopee, and Seller. |
Field definitions:Pending: The shipping fee responsibility has not yet been calculated.Seller: The seller is responsible for at least one applicable shipping fee. However, these will be covered by the Shopee Easy Return Programme if the seller is enrolled, subject to coverage and claim eligibility.Shopee: Shopee is responsible for the applicable shipping fees.As an optional field, this field may not be returned when the value is unavailable.This field is no longer applicable after the return request is cancelled or closed.
- The v2.returns.get_return_detail API will add the following response fields:
| Field Name |
Type |
Description |
| shipping_fee_responsibility |
string |
Indicates the party responsible for the applicable shipping fees for the return before accounting for Shopee Easy Return Programme coverage. Possible values are Pending, Shopee, and Seller. |
| shipping_fee_responsibility_reason |
string |
The reason code corresponding to the shipping fee responsibility value for the return. Detailed reason descriptions will be provided in the Open API Data Definition. |
Notes:This feature applies to normal return/refund requests from local sellers in Brazil.When the shipping fee responsibility has not yet been calculated, shipping_fee_responsibility will return Pending, and shipping_fee_responsibility_reason may be empty.The shipping fee responsibility may be recalculated based on the return progress or applicable rules. The APIs will return the latest result.After the return request is cancelled or closed, the shipping fee responsibility information may no longer be returned.The fields above will not be returned for sites outside Brazil or for non-local sellers in Brazil.shipping_fee_responsibility_reason returns a reason code. Sellers can refer to the mapping provided in the Open API Data Definition to obtain the corresponding reason description.
Affected APIs :v2.returns.get_return_listv2.returns.get_return_detail
Effective Date:September 14, 2026
Note:This feature will be gradually rolled out starting September 14, 2026. Shops that are not included in the rollout may temporarily be unable to use this feature. This is expected behavior.
Announcement URL: https://open.shopee.com/announcements/1556
@junie-agent Please review the API changes described above. Focus ONLY on major updates such as adding new endpoints or removing/taking legacy APIs offline. You can safely ignore any other changes regarding request/response parameters or fields. Update the PHP code and create a new PR for review. Close issue if nothing changes applied.
New Shopee's Openapi Announcement (ID: 1556)
Dear Developers
Please find below the OpenAPI updates released this time. These changes aim to enhance functionality, improve flexibility, and provide better integration support.
1. [BR] Return APIs Add Shipping Fee Responsibility and Reason Fields
Field definitions:Pending: The shipping fee responsibility has not yet been calculated.Seller: The seller is responsible for at least one applicable shipping fee. However, these will be covered by the Shopee Easy Return Programme if the seller is enrolled, subject to coverage and claim eligibility.Shopee: Shopee is responsible for the applicable shipping fees.As an optional field, this field may not be returned when the value is unavailable.This field is no longer applicable after the return request is cancelled or closed.
Notes:This feature applies to normal return/refund requests from local sellers in Brazil.When the shipping fee responsibility has not yet been calculated, shipping_fee_responsibility will return Pending, and shipping_fee_responsibility_reason may be empty.The shipping fee responsibility may be recalculated based on the return progress or applicable rules. The APIs will return the latest result.After the return request is cancelled or closed, the shipping fee responsibility information may no longer be returned.The fields above will not be returned for sites outside Brazil or for non-local sellers in Brazil.shipping_fee_responsibility_reason returns a reason code. Sellers can refer to the mapping provided in the Open API Data Definition to obtain the corresponding reason description.
Affected APIs :v2.returns.get_return_listv2.returns.get_return_detail
Effective Date:September 14, 2026
Note:This feature will be gradually rolled out starting September 14, 2026. Shops that are not included in the rollout may temporarily be unable to use this feature. This is expected behavior.
Announcement URL: https://open.shopee.com/announcements/1556
@junie-agent Please review the API changes described above. Focus ONLY on major updates such as adding new endpoints or removing/taking legacy APIs offline. You can safely ignore any other changes regarding request/response parameters or fields. Update the PHP code and create a new PR for review. Close issue if nothing changes applied.