API Guide :: Rejecting returned items in a transaction

Rejecting returned items in a transaction

If the returned items you received from the buyer are not in the same condition as when you sent them, you mark the items as rejected. This will then cause the transaction to enter arbitration.

Marking all returned items as rejected

Rejecting the returned items in a transaction will cause the transaction to enter arbitration. 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 sellers behalf if the inspection period lapses.

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_return"
}'

Marking individual returned items as rejected 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.

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_return"
}'