API Guide :: Rejecting items in a transaction

Rejecting items in a transaction

If the goods you receive are not what you expected in the transaction, then you can reject the items. You are then required to ship the goods back to the seller.

Marking all items as rejected

You can reject the items in a transaction if they are not what you expected, or if they are not in the condition you expected them to be in. Doing so requires you to ship the items back to the seller at the buyers expense. Accepting or rejecting the items must happen before the inspection period for the transaction completes as Escrow.com will automatically accept the goods on the buyer's behalf if the inspection period lapses.

Marking all of the items in a transaction as rejected is as simple as making a patch request tohttps://api.escrow.com/2017-09-01/transaction/idand setting the action field toreject.

If the API call is successful, it will return the updated transaction object.

1
2
3
4
5
6
7
8
curl "https://api.escrow.com/2017-09-01/transaction/2020" \
    -X PATCH \
    -u "email-address:your-api-key" \
    -H "Content-Type: application/json" \
    -d '
{
    "action": "reject"
}'

Rejecting individual items on a milestone transaction

For milestone transactions, you must mark individual items on a transaction as rejected. The request is similar to marking all of the items as rejected on a transaction, however you perform the patch request on the item subresource of the transaction.https://api.escrow.com/2017-09-01/transaction/transaction_id/item/item_id

If the API call is successful, it will return the updated transaction object.

1
2
3
4
5
6
7
8
curl "https://api.escrow.com/2017-09-01/transaction/2020/item/1999" \
    -X PATCH \
    -u "email-address:your-api-key" \
    -H "Content-Type: application/json" \
    -d '
{
    "action": "reject"
}'