Sign in
Physical Device Payments

Payment

Physical device payment api you can start payments on your physical devices
post/api/v1/physical/payment

Request body

application_keystring required

It is the key of your application on our environment

order_idstring required

order_id must be send as unique identifier of your each request. If you send the same value in different requests it would create a chaos, you can't be sure about your payment

amountstring required

It must be send in integer format by multipliying original value with 100. For example 1 must be 100, 3.42 must be 342

currencystring

Its default is TRY, if you want to use another currency please send it by ISO Code like USD, EUR

installment_countinteger

Its default is without installment, if you want to make installment please send the installment count

store_codestring required

Store Code

document_typeinteger

Document Type. Possible values 1:Receipt, 2:Invoice, 3:EInvoice, 4:EArchive, 5:Food, 6:Parking, 7:Prepayment, 8:InvoicePayment, 9:CurrentAccount

callback_api_urlstring required

The json result comes from physical device will be posted to this api url.

modestring

Please send it as 'T' for test purposes, otherwise it will be in production mode.

languagestring

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.

device_idsstring[]

Device Id

sales_personinteger

Sales person

device_ownerstring

Example request

{
  "application_key": "6e3cdaa3-65df-4eff-aed2-9d74387701dd",
  "order_id": "9ee3fd53-42f9-4f16-b454-77e6b714c2e9",
  "currency": "TRY",
  "installment_count": 1,
  "store_code": "M0004",
  "callback_api_url": "https://api.jetcheckout.com/api/v1/merchant/success",
  "mode": "T",
  "language": "tr",
  "sale_items": [
    {
      "name": "Kalem",
      "barcode": "250001",
      "qty": 2,
      "price": 5.1,
      "amount": 10.2,
      "tax_rate": 1
    }
  ],
  "pay_items": [
    {
      "amount": 10.2,
      "payment_type": 1,
      "credit_id": 2,
      "issuer_id": "1",
      "card_number": "1",
      "acquire_id": "1"
    }
  ],
  "customer_info": {
    "name": "ADZ Bilişim",
    "id": "326025"
  },
  "device_owner": "hugin"
}

Response

Successful Response

response_codestring

You will get 00 for successful payments, 00307 for needs redirection, otherwise another response code for the error. You can reach the list of response codes on the Response Codes Api

messagestring

Here is the explanation of response code

transaction_idstring

This is the unique id of your payment request in our system. You need to post it to redirect url when redirection needed

pos_order_numberstring

Physical pos device order number

Example response

{
  "response_code": "00",
  "message": "Successful Payment",
  "transaction_id": "a9bcbe48-0543-4a0d-be41-e423b64a5550",
  "pos_order_number": "102562"
}

Changes

No recorded changes to this endpoint across all 1 revision of this API.