Card Payment Transactions

Information Received in Payment by Card

These parameters are sent by Sipay

Params Type Description
card_tx_uniq_id long Provision Id
card_tx_correlation_id long Main Id Of The Provision (Refunds will come with this Id.)
tx_tenant_referance_id string
card_no string Card Number
tenant_customer_no string Tenant Customer No
tenant_wallet_no string Tenant Wallet No
transaction_type string Provision Transaction Type
request_type string Provision Action Type
terminal_type string Where the Transaction Begins
entry_type string
currency_code int Currency Code
base_amount decimal Main Transaction Amount
fee_amount decimal Commission Amount (The commission of the device initiating the transaction)
tax_amount decimal Tax Amount ( Tax commission of the device initiating the transaction)
total_amount decimal Total Amount
is_advice boolean Successful Response Area of ​​Provision
hash_key string Hash Key
merchant_name string Name of the Device From which the Provisioning Started
merchant_id string The Id of the Device from which the Provisioning Started
mcc string Category Code of the Device From Which Provision Started
qr_data string QR Information in Transaction with TR QR Code
request_date int Request Date
request_time int Request Time
txn_source string Transaction Source (N: Domestic, M: Mastercard (Abroad), V: Visa (Abroad)
rrn string Reference Number

Response Params

Params Type Description
correlationId int Id of the Provision
bankingRefNo string Bank's Transaction ID
balanceInformatıonList object List of Amount Information
type string Type
previousAmount decimal Previous Balance
CurrencyCode int Currency Code
CurrentAmount decimal Current Balance
TransactionAmount decimal Balance Information Transaction Amount
ResponseCode string Response Code
responseDescription string Response Description
responseMessage string Response Message
isApproved boolean Is It Approved ?

Information Received in Payment by Card :

{
  "card_tx_uniq_id": 4000001489104986,
  "card_tx_correlation_id": 4000001489104986,
  "tx_tenant_referance_id": "",
  "card_no": "434610tbkrea8640",
  "tenant_customer_no": "123123",
  "tenant_wallet_no"": "123123",
  "transaction_type": "SALE",
  "request_type": "NORMAL",
  "terminal_type": "PO",
  "entry_type": "M",
  "currency_code": "949",
  "base_amount": 15.00,
  "fee_amount": 0.00,
  "tax_amount": 0.00,
  "total_amount": 15.00,
  "is_advice": true,
  "hash_key": "",
  "merchant_name": "AKBANK/ USKUDAR ALTUNIZA ISTANBUL TR",
  "merchant_id": "094900001000020",
  "mcc": "6011",
  "qr_data" : "",
  "request_date" : 20211119,
  "request_time" : 112905,
  "txn_source": "M",
  "rrn": "1234567"
}

SUCCES RESPONSE:

{
  "correlationId": 4000001489104986,
  "bankingRefNo": "633719769028",
  "balanceInformationList": [
    {
      "type": "CURRENT",
      "previousAmount": 1000,
      "currencyCode": 949,
      "currentAmount": 985,
      "transactionAmount": 15.00
    }
  ],
  "responseCode": "00",
  "responseDescription": "Approved",
  "responseMessage": "Approved",
  "isApproved": true
}

UNSUCCESSFUL RESPONSE

{
  "correlationId": 4000001489104986,
  "bankingRefNo": "",
  "balanceInformationList": [],
  "responseCode": "51",
  "responseDescription": "Cüzdan Bakiyesi Yetersiz",
  "responseMessage": "Cüzdan Bakiyesi Yetersiz",
  "isApproved": false
}

Transaction Type

TransactionType RequestType Description
SALE NORMAL Provisioning / Card Asset Inquiry
REFUND REVERSAL Return of Provision
INQUIRY CANCEL (V- Void) Card Asset Inquiry
LIMIT_INQUIRY REVERSAL OF VOID Card Asset / Balance Inquiry
BALANCE_INQUIRY Physical Card Balance Inquiry
CASH_WITHDRAWAL Physical Card Cash Out Transaction
CASH_DEPOSIT Physical Card Cash Investment Transaction

Transaction Terminal Type

Code Description
PO Pos
AT Atm
EP Epos
IN Internet Banking
IV Ivr
VP Virtual Pos
CT Crt
BR Branch Screen
UA Unattended Pos
VL Validator
KI Kiosk

Response Code

Response Code Description
29 Original Not Found
94 Duplicated
51 Insufficent funds
57 Not allowed to card
96 System Error
05 Not Approved
61 Exceeds withdrawal amount limit
00 Approved