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