API Guide :: Accepting returned items in a transaction

Accepting returned items in a transaction

Once you have verified that the items you received from the buyer are what you expected and in the condition you expected, you mark the items as accepted. This allows us to go ahead and return the funds to the buyer.

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

Marking all returned items as accepted

Accepting the items in a transaction allows us to return the funds to the buyer in the transaction. 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.

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": "accept_return"
}'

Marking individual returned items as accepted on a milestone transaction

For milestone transactions, you must mark individual items on a transaction as accepted. The request is similar to marking all of the items as accepted 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": "accept_return"
}'