Payment with Juzdan
To get payment with Juzdan the first step is to start payment using Craftgate service. The service returns a QR url, the Merchant can open it on the browser. Then customer scans the QR code using Juzdan mobile application, selects one of the registered cards and completes the payment. Upon completion of the payment customer is redirected to the callback URL with referenceId parameter, then Merchant calls payment inquiry service and checks the status of the payment.
Start Payment With Juzdan
URL
Parameters are given below to create a QR url using Juzdan.
Payment Starting Request Parameters
URL which is going to be used to transfer referenceId to the merchant
If payment takes place on website "W", if payment takes place on mobile "M" should be sent.
Campaign ID
"boomerang" value that can be sent with the request and received with the response. It can be used to associate different requests with each other. Usually, the order number is used that is stored in merchant own system.
Special characters that may cause security problems should not be used in the data. Data cannot start with the + or - character, but it can be used in it.
It is generally used as a payment order number or basket number on the merchant side. You can search with this value later by using reporting services.
Special characters that may cause security problems should not be used in the data. Data cannot start with the + or - character, but it can be used in it.
Total basket price. The sum of the item prices in the basket must be equal to total basket price.
The final amount to be paid from the card by calculating differences such as commissions and discounts. The amount to be collected from the wallet is also included in this amount. If there is an interest in the transaction, the amount with the interest added should be entered in this parameter.
ID of the buyer that is returned from member creation.
It is generally used to keep information specific to the payment channel on the merchant side. You can search with this value later by using reporting services.
Order id parameter to be transmitted to the bank when receiving the payment. Since it is optional, it is recommended not to send it and the orderId value is generated by Craftgate.
Payment items related to payment. You must send at least one payment item and the sum of prices must be equal to the price field.
Response Parameters
Response parameters of Juzdan start payment obeys the rules of Response Formats. If there is no System error sub parameters of data object will be returned like the below.
Unique ID of the payment
QR URL which is created by Juzdan
Parameters that are sent to Callback URL
After payment is completed parameters below will be transferred as form variables using HTTP POST method to callbackUrl URl of the Merchant.
Unique ID of the payment
Payment Inquiry
After the payment referenceId is sent to Merchant's callbarkurl, Merchant can call the inquiry service of the Craftgate to view the status and other information about payment.
URL
You can use referenceId to inquire Juzdan payment.
Response Parameters Of Juzdan Inquiry
ID of the payment.
The date that payment is created
Basket price of the payment
Paid price of the payment
Wallet price of the payment
Buyer member ID of the payment
Installment number
Value of theconversationId parameter sent in the payment request
externalId value that sent in payment request by merchant
See: Payment Types
See: Payment Status
paymentChannel value sent by the merchant in the payment request
Indicates whether the payment is 3D Secure payment
Interest rate to calculate paid price that buyer will pay
Interest amount. Equal to the difference between paidPrice and price values
Bank commission rate
Bank commission rate amount
Card user key that represents the card holder.
Card token that represents the card.
Indicates whether the payment was made with a stored card
Exist for the payments fully or partially collected from the card. First 8 digits of the card
Exist for the payments fully or partially collected from the card. Last 4 digits of the card
Card holder name surname
Card holder name surname retrieved from bank. The return value might be null for PF poses
authCode value retrieved from bank related to the payment. The return value might be null for PF poses
hostReference value retrieved from bank related to the payment
transId value retrieved from bank related to the payment. The return value might be null for PF poses
orderId value retrieved from bank related to the payment
Card Association
Brand of card. Exist for the payments fully or partially collected from the card
Value of theposAlias parameter sent in the payment request
POS info that payment is received
Loyalty info that used in payment (See: Reward Usage)
Fraud Check Id if fraud rule matches (See: Fraud Checks)
Fraud Check Action if fraud rule matches (See: Fraud Actions)
It includes the transaction information sent when making the payment request, and the pricing and money transfer information of the payment based on these transactions
Additional data related to the payment
Sample Codes
You can review the sample codes in the open source Craftgate API clients.