# Payment Check

It shows transaction analysis that have done. You can use it for quick access to summary of payment.

{% hint style="warning" %}
You should perform basic authentication with secret\_key to use transaction check service. [See more](https://doc.paynet.com.tr/authentication#secret-key)
{% endhint %}

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

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

| Parameter Name    | Type   | Required | Description                                                                                     |
| ----------------- | ------ | -------- | ----------------------------------------------------------------------------------------------- |
| **xact\_id**      | string | Yes\*    | Paynet Transaction Id.                                                                          |
| **reference\_no** | string | Yes\*    | The number used in the payment process.Recommended to send a unique number in each transaction. |

{% endtab %}

{% tab title="Response Parameters" %}

| Parameter Name          | Type     | Description                                                                                            |
| ----------------------- | -------- | ------------------------------------------------------------------------------------------------------ |
| **Data\[]**             |          |                                                                                                        |
| =>xact\_id              | string   | Encrypted Transaction Id.                                                                              |
| =>id                    | string   | Encrypted Transaction Id.                                                                              |
| =>xact\_date            | datetime | Transaction Date.                                                                                      |
| =>transaction\_type     | char     | 1 for sale                                                                                             |
| =>pos\_type             | char     | 5: Paynet POS                                                                                          |
| =>is\_tds               | bool     | IF the transaction performed with 3D,this value return as true.                                        |
| =>agent\_id             | string   | Paynet agent code of the dealer that performed the transaction.                                        |
| =>note                  | string   | Description (data-description) that you used during checkout.                                          |
| =>ratio                 | float    | Rate that used during transaction.                                                                     |
| =>agent\_reference      | string   | Reference number that used in the payment process. It is same as with reference\_no.                   |
| =>bank\_id              | char     | The bank's code in the Paynet system.                                                                  |
| =>instalment            | int      | Installment count.[See More](https://doc.paynet.com.tr/genel-bilgiler/taksit-kodlari)                  |
| =>card\_type            | char     | Card Type. [See More](https://doc.paynet.com.tr/genel-bilgiler/veri-tipleri/kart-tipi)                 |
| =>card\_no              | string   | Masked card number.                                                                                    |
| =>card\_holder          | string   | Card owner.                                                                                            |
| =>amount                | decimal  | Amount that withdrawn from credit card.                                                                |
| =>net\_amount           | decimal  | Amount without commission.                                                                             |
| =>comission             | decimal  | Comission.                                                                                             |
| =>comission\_tax        | decimal  | Comission tax.                                                                                         |
| =>currency              | char     | Currency.                                                                                              |
| =>authorization\_code   | string   | Bank confirmation code.                                                                                |
| =>reference\_code       | string   | Bank reference code.                                                                                   |
| =>order\_id             | string   | Bank order no.                                                                                         |
| =>is\_succeed           | bool     | It shows that if operaiton is successful or not.                                                       |
| =>xact\_transaction\_id | guid     | Paynet transactşon tracking number.                                                                    |
| =>email                 | string   | Email.                                                                                                 |
| =>phone                 | string   | Phone number.                                                                                          |
| =>object\_name          | string   | Transaction.                                                                                           |
| =>code                  | string   | System result code .[ See more](https://doc.paynet.com.tr/genel-bilgiler/hata-kodlari/doenues-kodlari) |
| =>message               | string   | System message.                                                                                        |
| **object\_name**        | string   | Transaction.                                                                                           |
| **code**                | string   | System result code . [See more](https://doc.paynet.com.tr/genel-bilgiler/hata-kodlari/doenues-kodlari) |
| **message**             | string   | System message.                                                                                        |
| {% endtab %}            |          |                                                                                                        |

{% tab title="Request" %}

```
{  
   xact_id:"xk_EAAAAAh7VYf9HG4+GR9ezqiMWAA8PY6P4eroE4BUUHRCLxGO"
}
```

{% endtab %}

{% tab title="Response" %}

```
{
    "Data": [
        {
            "id": 2527054,
            "xact_id": "xk_EAAAABjNNQXkp5xN4RyKCdjOn*WlCyAZUfIh7tvswL7Sxnol",
            "xact_date": "2020-02-27T11:00:19.16",
            "transaction_type": 1,
            "pos_type": 5,
            "agent_id": "10",
            "is_tds": false,
            "bank_id": "AXSS",
            "instalment": 0,
            "card_no": "435508******4358",
            "card_holder": "TEST",
            "card_type": "bc",
            "ratio": 0.035,
            "amount": 20.0000,
            "netAmount": 19.3000,
            "comission": 0.7000,
            "comission_tax": 0.0000,
            "currency": "TRY",
            "authorization_code": "aut-4923",
            "reference_code": "ref-4923",
            "order_id": "order-4923",
            "is_succeed": true,
            "xact_transaction_id": "6FA9F0CE-9D3D-4625-B985-DE390F72E78F",
            "email": "",
            "phone": "          ",
            "note": "test 2",
            "agent_reference": "test",
            "object_name": "transaction",
            "code": 0,
            "message": "Başarılı İşlem"
        }
    ],
    "object_name": "transaction",
    "code": 0,
    "message": "Başarılı İşlem"
}
```

{% endtab %}

{% tab title="Service Url" %}

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

{% hint style="info" %}
You need to post at least **xact\_id** or **reference\_id**.
{% 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/payment-check.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.