Shippo

Interact with Shippo API

Actions68

Parcels Actions
- Create Parcel
- Get Parcel
- List Parcels
Shipments Actions
- List Shipments
- Create Shipment
- Get Shipment
Rates Actions
- Get Rate
- List Shipment Rates
- List Shipment Rates By Currency Code
Transactions Actions
- List Transactions
- Create Transaction
- Get Transaction
Customs Items Actions
- List Customs Items
- Create Customs Item
- Get Customs Item
Tracking Status Actions
- Create Track
- Get Track
Batches Actions
- Create Batch
- Get Batch
- Add Shipments To Batch
- Purchase Batch
- Remove Shipments From Batch
Orders Actions
- List Orders
- Create Order
- Get Order
Pickups Actions
- Create Pickup
Service Groups Actions
- List Service Groups
- Create Service Group
- Update Service Group
- Delete Service Group
Customs Declarations Actions
- List Customs Declarations
- Create Customs Declaration
- Get Customs Declaration
Refunds Actions
- Create Refund
- List Refunds
- Get Refund
Manifests Actions
- List Manifests
- Create Manifest
- Get Manifest
Carrier Accounts Actions
- List Carrier Accounts
- Create Carrier Account
- Get Carrier Account
- Update Carrier Account
- Initiate Oauth 2 Signin
- Register Carrier Account
- Get Carrier Registration Status
Webhooks Actions
- Get Webhook
- Update Webhook
- Delete Webhook
Carrier Parcel Templates Actions
- List Carrier Parcel Templates
- Get Carrier Parcel Template
User Parcel Templates Actions
- List User Parcel Templates
- Create User Parcel Template
- Delete User Parcel Template
- Get User Parcel Template
- Update User Parcel Template
Rates At Checkout Actions
- Create Live Rate
- Get Default Parcel Template
- Update Default Parcel Template
- Delete Default Parcel Template
Shippo Accounts Actions
- List Shippo Accounts
- Create Shippo Account
- Get Shippo Account
- Update Shippo Account
Addresses Actions
- List Addresses
- Create Address
- Get Address
- Validate Address

Overview

This node integrates with the Shippo API to create a refund for a specific transaction. It is useful in e-commerce or shipping workflows where you need to programmatically issue refunds for shipments or transactions processed through Shippo. For example, after a customer cancels an order or a shipment fails, this node can automate the refund process by creating a refund request via the Shippo API.

Properties

Name	Meaning
SHIPPO API VERSION	Optional string to specify a non-default Shippo API version to use. Useful if you want to target a specific API version.
Async	Boolean flag indicating whether the refund creation should be processed asynchronously (`true`) or synchronously (`false`).
Transaction	The unique identifier of the transaction for which the refund is being created. This is required to specify the refund target.

Output

The node outputs JSON data representing the response from the Shippo API after attempting to create the refund. This typically includes details about the refund status, refund ID, and related transaction information. The output does not include binary data.

Dependencies

Requires an API key credential for authenticating with the Shippo API.
The node sends requests to https://api.goshippo.com.
Optionally supports specifying a custom API version via a header.
No other external dependencies are indicated.

Troubleshooting

Common issues:
- Missing or invalid API key will cause authentication errors.
- Providing an incorrect or non-existent transaction ID will result in errors from the Shippo API.
- If asynchronous processing is enabled but the system expects immediate confirmation, it may cause confusion about refund status.
Error messages:
- Authentication failures usually indicate problems with the API key; verify that the correct key is configured.
- Validation errors from the API often mean required fields like the transaction ID are missing or malformed.
- Network or connectivity errors suggest checking internet access or Shippo service status.