---
title: "Pay With Wallet"
method: POST
path: "/api/v1/payment/wallet"
tags: ["Pay With Wallets"]
---

# Pay With Wallet

`POST /api/v1/payment/wallet`

Pay with wallet api you can get payments from your customer

## Request body

- WalletPayRequest
  - `application_key` string, required — It is the key of your application on our environment
  - `order_id` string, 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
  - `amount` string, 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
  - `currency` string — Its default is TRY, if you want to use another currency please send it by ISO Code like USD, EUR
  - `service` string, required — Wallet Service Provider name must be sent
  - `wallet_id` integer, required — Wallet Service Provider wallet id must be sent
  - `installment_count` string — Its default is without installment, if you want to make installment please send the installment count as string. This info sends to payment services which supports installment count feature.
  - `hash_data` string, 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_url` string, required — If process result is success it will be posted this url with your order_id.
  - `fail_url` string, 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.
  - `mode` string — Please send it as 'T' for test purposes, otherwise it will be in production mode.
  - `language` 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.
  - `customer` Customer
    - `email` string — Email of your customer.
    - `name` string — Name of your customer, if you don't send it, card_holder_name will be used in required payment services.
    - `surname` string — Name of your customer, if you don't send it, card_holder_name will be used in required payment services.
    - `address` string — Address of your customer.
    - `postal_code` string — Postal code of your customer address.
    - `company` string — Comapny name of your customer.
    - `phone` string — Phone number of your customer.
    - `ip_address` string — IP address of client.
    - `id` string — Customer id
    - `identity_number` string — Customer identity number or tax number
    - `county` string — Customer County
    - `city` string — Customer City
    - `country` string — Customer Country
  - `customer_basket` BasketItem[] — Content of order. Our api acts like card number.
    - `id` string, required — Item id
    - `name` string, required — Name of item.
    - `description` string, required — Item description
    - `qty` integer, required — Quantiy of item
    - `amount` number, required — Total amount of item
    - `is_physical` boolean — Item is a physical product ?
    - `category` string, required — Item category
    - `submerchant_external_id` string — Submerchant Unique Id in your system. It is required when the payment is submerchant payment.
    - `submerchant_price` number — Submerchant Payment Amount. It is required when the payment is submerchant payment.
  - `billing_address` Address
    - `contactName` string — Contact name
    - `address` string — Address info.
    - `county` string — Customer County
    - `city` string — City
    - `country` string — Country
  - `shipping_address` Address
    - `contactName` string — Contact name
    - `address` string — Address info.
    - `county` string — Customer County
    - `city` string — City
    - `country` string — Country

## Response `200`

Successful Response

- WalletPayResponse
  - `response_code` string
  - `message` string
  - `suggestion` string
  - `service_resp_code` string
  - `service_resp_message` string
  - `transaction_id` string
  - `redirect_url` string
  - `qr` string

## 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)