# 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 %}