# Transaction Details

It returns to detailed information of the credit card transaction made. You can make a query with reference number that used during payment or Paynet transaction number.

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

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

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

| Parameter Name    | Type   | Required | Description                                                                                               |
| ----------------- | ------ | -------- | --------------------------------------------------------------------------------------------------------- |
| **id**            | string | Yes\*    | Unencrypted Paynet Transaction Id.                                                                        |
| **xact\_id**      | string | Yes\*    | Paynet Transaction Id.                                                                                    |
| **xact**          | string | Yes\*    | Unencrypted Paynet Transaction Id.                                                                        |
| **reference\_no** | string | Yes\*    | Reference number that used in the payment. It is recommended to send a unique number in each transaction. |
| **user\_id**      | string | No       | Paynet User Code.                                                                                         |
| {% endtab %}      |        |          |                                                                                                           |

{% tab title="Response Parameters" %}

| Parameter Name                   | Type     | Description                                                                                                                     |
| -------------------------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------- |
| **Data\[]**                      |          |                                                                                                                                 |
| =>id                             | string   | Transaction Id.                                                                                                                 |
| =>xact\_id                       | string   | Transaction id.                                                                                                                 |
| =>xact\_date                     | datetime | Date of the transaction.                                                                                                        |
| =>transaction\_type              | char     | Sales:1/ Reversal:2/ PreAuth:3 /Capture:4/ PreAuthReversal:5 /CaptureReversal:6 /Query:7/ Credit:9/ PointUse:10/ PointReturn:11 |
| =>xact\_type\_desc               | string   | Description of Transaction Type.                                                                                                |
| =>channel\_id                    | string   | ID of a Channel that transaction made.                                                                                          |
| =>pos\_type                      | char     | 5: Paynet POS / 1: “Süpürmeli POS”.                                                                                             |
| =>pos\_type\_desc                | string   | Description of Pos type.                                                                                                        |
| =>is\_tds                        | bool     | If transaction is 3D, then it is true.                                                                                          |
| =>agent\_id                      | string   | Paynet agent code of the dealer that performed the transaction.                                                                 |
| =>agent\_name                    | string   | Agent Name.                                                                                                                     |
| =>company\_name                  | string   | Parent company Name.                                                                                                            |
| =>company\_code                  | string   | Parent company Code.                                                                                                            |
| =>user\_name                     | string   | User Information that used during payment transaction.                                                                          |
| =>note                           | string   | Description that used during payment transaction (data-description).                                                            |
| =>ratio                          | float    | Rate that used during payment transaction.                                                                                      |
| =>ratio\_code                    | string   | Ratio code that used during payment transaction.                                                                                |
| =>ratio\_code\_method            | string   | Ratio code method that used during payment transaction.                                                                         |
| =>end\_user\_ratio               | string   | End User Ratio.                                                                                                                 |
| =>agent\_reference               | string   | Reference number that used in the payment transaction.                                                                          |
| =>bank\_id                       | char     | The bank's code in the Paynet system.                                                                                           |
| =>bank\_name                     | string   | Name of the bank.                                                                                                               |
| =>instalment                     | int      | Number of instalment.                                                                                                           |
| =>instalment\_text               | string   | Description of instalment.                                                                                                      |
| =>payment\_string                | string   | Payment Plan.                                                                                                                   |
| =>short\_name                    | string   | Short name.                                                                                                                     |
| =>is\_from\_mail\_order          | bool     | If payment transaction went through Paylink, it is true. Otherwise, false.                                                      |
| =>mail\_order\_user\_name        | string   | Username in payment transaction that went through Paylink.                                                                      |
| =>campaign\_url                  | string   | The url showing the banks' plus installment and installment postpone selection screen.                                          |
| =>campaign\_text                 | string   | Campain Description.                                                                                                            |
| =>cancel\_status                 | string   | Cancellation/Refund Status.                                                                                                     |
| =>plus\_installment              | string   | Plus installment count.                                                                                                         |
| =>card\_no                       | string   | Masked card number.                                                                                                             |
| =>card\_holder                   | string   | Card owner.                                                                                                                     |
| =>card\_type                     | char     | Card Type. See More                                                                                                             |
| =>card\_brand\_name              | string   | Brand of Card Bank (VISA, MASTERCARD, AMEX).                                                                                    |
| =>amount                         | decimal  | Amount that withdrawn from credit card.                                                                                         |
| =>netAmount                      | decimal  | Amount without commission.                                                                                                      |
| =>comission                      | decimal  | Commission.                                                                                                                     |
| =>end\_user\_comission           | string   | Comission tax.                                                                                                                  |
| =>comission\_tax                 | decimal  | End user commission.                                                                                                            |
| =>currency                       | char     | Currency.                                                                                                                       |
| =>authorization\_code            | string   | Bank confirmation code.                                                                                                         |
| =>reference\_code                | string   | Bank reference code.                                                                                                            |
| =>order\_id                      | string   | Bank order no.                                                                                                                  |
| =>is\_succeed                    | bool     | Shows that if transactions is successful or not.                                                                                |
| =>reversed                       | bool     | True/False , if transaction is cancelled then returns true.                                                                     |
| =>reversed\_xact\_id             | string   | It shows that transaction is canceled in transactions with transaction type.                                                    |
| =>reversal\_available            | bool     | Refund Authorization Control.                                                                                                   |
| =>reversal\_remain\_amount       | decimal  | Amount remained after cancellation/refund.                                                                                      |
| =>xact\_transaction\_id          | guid     | Paynet transaction tracking number.                                                                                             |
| =>email                          | string   | Email about payment.                                                                                                            |
| =>phone                          | string   | Phone number about payment.                                                                                                     |
| =>domain                         | string   | Domain information of the application where the transaction is made (eg: [www.acme.com](http://www.acme.com)).                  |
| =>company\_amount                | decimal  | As a result of this transaction, the gross receivable of the parent company.                                                    |
| =>company\_commission            | decimal  | The amount of service fee to be charged to the parent company as a result of this transaction.                                  |
| =>company\_commission\_with\_tax | decimal  | As a result of this transaction, the amount of service fee with VAT, to be deducted to the parent company.                      |
| =>company\_net\_amount           | decimal  | Net amount to pay parent company.                                                                                               |
| =>agent\_amount                  | decimal  | As a result of this transaction, the gross receivable of the dealer.                                                            |
| =>agent\_commission              | decimal  | The amount of service fee to be charged to the dealer as a result of this transaction.                                          |
| =>agent\_commission\_with\_tax   | decimal  | As a result of this transaction, the amount of service fee with VAT, to be deducted to the dealer.                              |
| =>agent\_net\_amount             | decimal  | Net amount to pay dealer.                                                                                                       |
| =>company\_cost\_ratio           | float    | Value of Parent company service fee.                                                                                            |
| =>company\_pay\_ratio            | float    | The payment ratio between the parent company and the dealer.                                                                    |
| =>company\_vdate                 | datetime | Due date of parent company.                                                                                                     |
| =>agent\_vdate                   | datetime | Due date of parent company.                                                                                                     |
| =>ipaddress                      | string   | IP address of the transaction.                                                                                                  |
| =>client\_id                     | guid     | Client id of the transaction.                                                                                                   |
| =>object\_name                   | string   | Transaction.                                                                                                                    |
| =>code                           | string   | System Response Code. See more                                                                                                  |
| =>message                        | string   | System Message.                                                                                                                 |
| **object\_name**                 | string   | Transaction.                                                                                                                    |
| **code**                         | string   | System Response Code. See more                                                                                                  |
| **message**                      | string   | System Message.                                                                                                                 |
| {% endtab %}                     |          |                                                                                                                                 |

{% tab title="Request" %}

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

{% endtab %}

{% tab title="Response" %}

```
{
    "Data": [
        {
            "xact_id": "xk_EAAAAANMxo5L9mbloNAKOlBvthIjsE8xFTyR1zno4TQag7tP",
            "xact_date": "2020-02-26T15:44:42.157",
            "transaction_type": 1,
            "pos_type": 5,
            "agent_id": "1001",
            "is_tds": true,
            "bank_id": "MAXM",
            "bank_name": "İş bankası",
            "instalment": 0,
            "card_no": "435508******4358",
            "card_brand_name": "Maximum",
            "card_holder": "Paynet",
            "card_type": "cc",
            "ratio": 0.0159,
            "end_user_ratio": 0,
            "amount": 21.13,
            "netAmount": 20.79,
            "comission": 0.34,
            "end_user_comission": 0,
            "comission_tax": 0,
            "currency": "TRY",
            "authorization_code": "638201",
            "reference_code": "005715421739",
            "order_id": "9C37AF7821AC4CFC8EE923EBA7DE33C9",
            "is_succeed": true,
            "reversed": false,
            "reversed_xact_id": "xk_EAAAANxxw5/89flAlvE6PHF8CtjyOp4K6cXObjuNUIau8t/i",
            "reversal_available": true,
            "reversal_remain_amount": 21.13,
            "xact_transaction_id": "9C37AF78-21AC-4CFC-8EE9-23EBA7DE33C9",
            "email": "",
            "phone": "          ",
            "note": "Kart bilgilerinizi girip ödemeyi tamamla butonuna tıklayınız",
            "agent_reference": "",
            "company_amount": 0,
            "company_commission": 0,
            "company_commission_with_tax": 0,
            "company_net_amount": 0,
            "agent_amount": 21.13,
            "agent_commission": 0.34,
            "agent_commission_with_tax": 0.34,
            "agent_net_amount": 20.79,
            "company_cost_ratio": 0,
            "company_pay_ratio": 0,
            "company_vdate": "0001-01-01T00:00:00",
            "agent_vdate": "2020-02-28T00:00:00",
            "xact_type_desc": "Satış",
            "payment_string": "Maximum  Tek çekim",
            "pos_type_desc": "Paynet POS",
            "agent_name": "Paynet Ödeme Hizmetleri",
            "company_name": "PAYNET PF ÜYE FİRMA",
            "instalment_text": "Tek Çekim",
            "ipaddress": "127.0.0.0",
            "client_id": "                                    ",
            "ratio_code": "S1SNWPGC",
            "ratio_code_method": "D",
            "domain": "https://paynet.com.tr",
            "user_name": "PaynetApi",
            "company_code": "1001",
            "id": 7453380,
            "channel_id": 2,
            "short_name": "İş bankası",
            "is_from_mail_order": false,
            "mail_order_user_name": "",
            "api_file": "",
            "campaign_url": "",
            "campaign_txt": "",
            "cancel_status": null,
            "plus_installment": 0,
            "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/detail> |
| **Test System** | <https://pts-api.paynet.com.tr/v1/transaction/detail>  |
| {% endtab %}    |                                                        |
| {% endtabs %}   |                                                        |

{% hint style="info" %}
You need to post at least **id**, **xact**, **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/transaction-details.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.
