The options that EasyPost offers for third-party billing are outlined below. You'd want to use the payment and duty_payment options to specify billing for postage, duties, and taxes.
For the duty_payment object to bill an account for duties and taxes, here are the requirements:
-
type - (string) Supported values:
- "SENDER" (FedEx Default)
- "THIRD_PARTY"
- "RECEIVER"
- account - (string) Account number to be billed.
- country - (string) Country code of the billing account.
- postal_code - (string) Postal code of the account location.
NOTE: This is only supported for BYOCA FedEx and UPS accounts.
For the payment object to bill an account for the cost of the label, you will supply the following requirements:
- type - (string) Supported values:
-
- "SENDER" (default)
- "THIRD_PARTY"
- "RECEIVER"
- "COLLECT"
-
account - (string) Account number to be billed. Required if
typeis "RECEIVER" or "THIRD_PARTY". -
country - (string) Country code of the billing account. Required if
typeis "THIRD_PARTY". -
postal_code - (string) Postal code of the billing account. Required if
typeis "RECEIVER" or "THIRD_PARTY".
NOTE: Only BYOCA accounts support this object. If you want to confirm if a specific carrier supports this object, please contact support!
Here is a JSON example of how you'd set these options up accordingly:
"options": {
"payment": {
"type": "THIRD_PARTY",
"account": "123456789",
"country": "US",
"postal_code": "84123"
},
"duty_payment": {
"type": "THIRD_PARTY",
"account": "123456789",
"country": "US",
"postal_code": "84123"
}
}
Some errors to be aware of with FedEx and UPS that are related to the account number or account details:
- The UPS account number provided as the payment method cannot be billed, please try another account.
- UPS account number that was provided as the payment method is missing or invalid.
- FedEx returned error: ShippingChargesPayment Payor - The payor's account number is invalid.
If you see any of these errors or an error like this, please confirm with the third-party that all information is correct and their account is enabled for third party billing on the carrier side. If the mentioned is confirmed, please contact support!