API Guide :: Agreeing to a transaction

Agreeing to a transaction

When the transaction is created, the terms of the transaction are automatically agreed to by the initiating party. However, it is required that the other parties in the transaction agree to the transaction before the transaction can move ahead.

Agreeing to a transaction is done by calling the transaction endpoint withaction set to agree.

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/29292" \
    -X PATCH \
    -u "email-address:your-api-key" \
    -H "Content-Type: application/json" \
    -d '
{
  "action": "agree"
}'

Once you have agreed to the transaction, you can select your payment method and fund the transaction.

Generating an agreement link

As an alternative to agreeing to the transaction directly, a link can be generated to reach an Escrow.com page on which the agree action can occur. This feature may be most useful when performed on behalf of another customer as per the the API Basics page.

1
2
3
4
curl "https://api.escrow.com/2017-09-01/transaction/29292/web_link/agree" \
    -X GET \
    -u "email-address:your-api-key" \
    -H "Content-Type: application/json"

Example response

1
2
3
{
  "landing_page": "https://www.escrow.com/agree?tid=900518&token=4debae8d-6c52-43c9-ae67-e6bfc0737486"
}