# Escrow Status Update

It is the service where the transaction will be approved or disapproved in escrow transactions.

{% hint style="success" %}
<https://api.paynet.com.tr/v1/transaction/escrow\\_status\\_update>
{% endhint %}

{% tabs %}
{% tab title="Request Parameters" %}

| Parameter Name    | Type    | Required | Description                                                                                                                               |
| ----------------- | ------- | -------- | ----------------------------------------------------------------------------------------------------------------------------------------- |
| **xact\_id\***    | string  | Yes      | Paynet Transaction Id.                                                                                                                    |
| **xact\***        | int     | Yes      | Unencrypted Paynet Transaction Id.                                                                                                        |
| **note**          | string  | No       | It is the note you will receive confirming or rejecting the transaction. Must be a maximum of 256 characters.                             |
| **status**        | int     | Yes      | You need to write "2" if you approve the transaction, "3" if you reject it.                                                               |
| **agent\_id**     | string  | No       | The area where the main company will determine which dealer it will pay to.                                                               |
| **agent\_amount** | decimal | No       | It is the information on how much of the amount sent in the first payment record of the parent company will be transferred to the dealer. |
| {% endtab %}      |         |          |                                                                                                                                           |

{% tab title="Response Parameters" %}

| Parameter Name   | Type   | Description                                                                                                    |
| ---------------- | ------ | -------------------------------------------------------------------------------------------------------------- |
| **object\_name** | string | The object name of response API.                                                                               |
| **code**         | string | The code of response result. [See more](https://doc.paynet.com.tr/genel-bilgiler/hata-kodlari/doenues-kodlari) |
| **message**      | string | Response result message.                                                                                       |
| {% endtab %}     |        |                                                                                                                |

{% tab title="Request" %}

```
{ 
"xact_id":"xk_EAAAAMzj8EmdfJKZCh79xPHIlfL62pfo6Q08T3frlnV/97HY",
"xact":"2531058",
"note":"Onaylıyorum",
"status":2
}
```

{% endtab %}

{% tab title="Response" %}

```
{
"object_name": null,
"code": 0,
"message": "Başarılı İşlem"
}
```

{% endtab %}

{% tab title="Service Url" %}

| System          | URL                                                                      |
| --------------- | ------------------------------------------------------------------------ |
| **Live System** | <https://api.paynet.com.tr/v1/transaction/escrow\\_status\\_update>      |
| **Test System** | ​<https://pts-api.paynet.com.tr/v1/transaction/escrow\\_status\\_update> |
| {% endtab %}    |                                                                          |
| {% endtabs %}   |                                                                          |

{% hint style="info" %}
**You need to post at least one of the xact\_id or xact.**
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://doc.paynet.com.tr/english/transaction/escrow-status-update.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.