---
title: "Payment Status"
method: POST
path: "/api/v1/payment/status"
tags: ["Payments"]
---

# Payment Status

`POST /api/v1/payment/status`

## Request body

- PaymentStatusRequest
  - `application_key` string, required — It is the key of your application on our environment
  - `order_id` string, required — It must be one the order_id's that you send to payment request previously.
  - `lang` string — Its default value is tr. If you want to get messages in other languages, please send it. You can find supported languages in the api supported_languages.

## Response `200`

Successful Response

- PaymentStatusResponse
  - `response_code` string — The status of query operation. 00200 means it is successful, 00404 means no transaction with the queried order_id
  - `message` string — Here is the explanation of response code
  - `order_id` string — The queried order_id
  - `transaction_id` string — Unique id of payment order in our system
  - `transaction_date` string — Payment transaction date
  - `virtual_pos_name` string — Virtual pos name the payment had been processed
  - `virtual_pos_id` integer — Virtual pos id the payment had been processed
  - `successful` boolean — Describes the payment is successful or not
  - `completed` boolean — Describes the payment is completed or not
  - `is_3d` boolean — Describes the payment is done with 3d secure process
  - `amount` number — Payment requested amount
  - `paid_amount` number — Payment amount
  - `rem_amount` number — Remaining Payment amount
  - `commission_amount` number — Payment commission amount
  - `expected_cost_rate` number — Payment expected cost rate
  - `expected_cost_amount` number — Payment expected cost amount
  - `payment_system` string — Payment System
  - `currency` string — Payment currency
  - `installment_count` integer — Installment count
  - `inst_period` integer — Installment period
  - `auth_code` string — Bank authorization code
  - `service_ref_id` string — Payment unique reference id on payment organisation
  - `cancelled` boolean — It is true if the payment cancelled on same day
  - `refund_amount` number — Payment refund amount
  - `bin_code` string — Card Bin Code
  - `card_type` string — Card Type
  - `card_program` string — Card Program
  - `card_family` string — Card Family
  - `card_bank_eft_code` string — Card Bank Eft Code
  - `card_bank_name` string — Card Bank Name
  - `pos_bank_eft_code` string — Pos Bank Eft Code
  - `pos_bank_name` string — Pos Bank Name
  - `error_message` string — Error message
  - `payment_response_code` string — Payment response code
  - `payment_response_message` string — Payment response message
  - `credit_bank` string — Credit Bank EFT Code
  - `credit_status` 'Unknown' | 'Approved' | 'Cancelled' | 'Refund' | 'PartialRefund' | 'BankProcess' | 'NewCustomer' — An enumeration.
  - `preauth` boolean — Payment is pre auth ?
  - `postauth` boolean — Pre auth payment is approved ?
  - `approval_code` string — Bank authorization code
  - `bank_trace_number` string — Bank Trace No
  - `items` PaymentTransactionItem[]
    - `id` integer
    - `transaction_id` integer
    - `item_id` string
    - `item_transaction_id` string
    - `amount` number
    - `refund_amount` number
    - `submerchant_id` integer
    - `submerchant_external_id` string
    - `submerchant_amount` number
    - `submerchant_pay_approved` boolean
    - `submerchant_key` string
  - `refunds` PaymentCancelTransaction[]
    - `id` integer
    - `transaction_id` integer
    - `transaction_date` string
    - `is_success` boolean
    - `amount` number
    - `response_code` string
    - `response_message` string
    - `process_type` string
    - `completed` boolean

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/jetcheckout/apis/jet-checkout.md) · [All operations](https://skmtc.dev/jetcheckout/apis/jet-checkout/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/jetcheckout/jet-checkout/revisions/b17a3806ccb0/schema)