Skip to content

EasyPost - Refund Shipment

This module requests a refund for a previously purchased shipment in EasyPost. It receives the shipment ID and makes a POST request to the /shipments/{shipment_id}/refund endpoint. It returns the refund status and the updated shipment status.

ParameterTypeRequiredDescription
credentials_idcredentialsYesEasyPost credential (provider: easypost)
shipment_idtextYesShipment ID to refund (shp_…)

A easypost type credential is required with the following fields:

  • api_key: EasyPost API Key
{
"success": true,
"shipment_id": "shp_abc123",
"refund_status": "submitted",
"status": "refunded",
"message": "Reembolso solicitado: submitted"
}
{
"credentials_id": "mi_credencial_easypost",
"shipment_id": "shp_abc123"
}
  • The refund can have different statuses: submitted, refunded, rejected
  • USPS refunds are generally approved automatically if the label was not scanned
  • Refund processing time depends on the carrier
  • Only shipments that have been purchased but not delivered can be refunded