Soft POS Payments

Soft Pos Payment

Soft POS api you can get payments from your customer

post/api/v1/payment/softpos

Request body

application_keystring required

It is the key of your application on our environment

user_emailstring

User Email it is required for iyzico Cep POS v2 integration

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

card_family_idinteger

Card Family Id

installment_countinteger

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

hash_datastring required

This is the calculated hash data for this sample payment request. BASE_64_ENCODE( SHA_256( APPLICATION_KEY + ORDER_ID + AMOUNT + SECRET_KEY ) )

success_urlstring required

If process result is success it will be posted this url with your order_id.

fail_urlstring required

If process failed it will be posted this url with your order_id, response_code and message. You can reach our all response codes from response code api.

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.

v2_activeboolean

Send True if you want to use iyzico SoftPOS version 2

Example request

{
  "application_key": "6e3cdaa3-65df-4eff-aed2-9d74387701dd",
  "user_email": "kullanici1@iyzico.com",
  "order_id": "9ee3fd53-42f9-4f16-b454-77e6b714c2e9",
  "currency": "TRY",
  "installment_count": 1,
  "hash_data": "sadsaas3e412",
  "success_url": "https://api.jetcheckout.com/api/v1/merchant/success",
  "fail_url": "https://api.jetcheckout.com/api/v1/merchant/fail",
  "mode": "T",
  "language": "tr",
  "customer": {
    "email": "ahmetyigit@xyz.com",
    "name": "Ahmet",
    "surname": "Yiğit",
    "address": "Nidakule Göztepe, Merdivenköy Mah. Bora Sok. No:1",
    "postal_code": "34738",
    "company": "34738",
    "phone": "+905350000000",
    "ip_address": "1.1.111.111",
    "id": "135",
    "identity_number": "74300864791",
    "county": "Konak",
    "city": "İzmir",
    "country": "Türkiye"
  },
  "customer_basket": [
    {
      "id": "KL015",
      "name": "Kalem",
      "description": "Tükenmez Mavi Kalem",
      "qty": 1,
      "is_physical": true,
      "category": "Kırtasiye",
      "submerchant_external_id": "Kırtasiye"
    }
  ],
  "billing_address": {
    "contactName": "Aysel Solmaz",
    "address": "Nidakule Göztepe, Merdivenköy Mah. Bora Sok. No:1",
    "county": "Konak",
    "city": "İzmir",
    "country": "Türkiye"
  },
  "shipping_address": {
    "contactName": "Aysel Solmaz",
    "address": "Nidakule Göztepe, Merdivenköy Mah. Bora Sok. No:1",
    "county": "Konak",
    "city": "İzmir",
    "country": "Türkiye"
  }
}

Response

Successful Response

response_codestring

messagestring

suggestionstring

service_resp_codestring

service_resp_messagestring

transaction_idstring

redirect_urlstring

Changes

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