Payment Integration Services
1. Hosted Payment Page #
Desired values are posted and transactions are redirected to Nkolay Hosted Payment page. Card information goes directly to Nkolay servers, security is provided by Nkolay. iFrame integration can be done within the site.
- Payment Processing with Hosted Payment Page (by sending form)
- Payment Processing with Hosted Payment Page (by creating link)
2. Payment by Link #
Payment link is sent to the card user via SMS or email. User clicks the link and is redirected to Nkolay Hosted Payment page, transactions are performed here.
3. API - Structure Where Card Information is Collected by Merchant #
Merchant collects card information on their own page and processes transactions via Nkolay API. In this structure, since card information is collected by the merchant, PCI DSS requirements belong to the merchant.
Test environment informationsx (Token): 118591467|bScbGDYCtPf7SS1N6PQ6/+58rFhW1WpsWINqvkJFaJlu6bMH2tgPKDQtjeA5vClpzJP24uA0vx7OX53cP3SgUspa4EvYix+1C3aXe++8glUvu9Oyyj3v300p5NP7ro/9K57Zcw== sx list: 118591467|bScbGDYCtPf7SS1N6PQ6/+58rFhW1WpsWINqvkJFaJlu6bMH2tgPKDQtjeA5vClpzJP24uA0vx7OX53cP3SgUspa4EvYix+1C3aXe++8glUvu9Oyyj3v300p5NP7ro/9K57Zcw==|3hJpHVF2cqvcCZ4q6F7rcA== sx cancel: 118591467|bScbGDYCtPf7SS1N6PQ6/+58rFhW1WpsWINqvkJFaJlu6bMH2tgPKDQtjeA5vClpzJP24uA0vx7OX53cP3SgUspa4EvYix+1C3aXe++8glUvu9Oyyj3v300p5NP7ro/9K57Zcw==|yDUZaCk6rsoHZJWI3d471A/+TJA7C81X Merchant Secret Key: _YckdxUbv4vrnMUZ6VQsr URL: https://paynkolaytest.nkolayislem.com.tr/Vpos
Using Hosted Payment Page by Sending Form #
To receive payments, the values given specifically to you are sent by posting to the Test environment URL: https://paynkolaytest.nkolayislem.com.tr/Vpos using HTTP POST method.
Production environment URL: https://paynkolay.nkolayislem.com.tr/Vpos
Form Variables Information #
The parameters you can POST to the service are as follows. All parameters must be sent in the request body using standard HTML Form Post method.
Application Flow:
- Validity check is performed on the information you send in the form, if there is missing or incorrect information, an error message is returned and the flow ends.
- The information you send in the form is checked. If it is not correct, the flow ends with an error message.
- If the information you send in the form is correct, the form where credit card information will be entered is displayed.
- After entering credit card information in the form, installment options are displayed when leaving this field. Single payment is selected as default.
- After entering all credit card information and selecting the appropriate installment option, the payment transaction is performed by pressing the "Complete Payment" button.
- If the payment transaction will be 3D, the flow is redirected to the 3D page, if not 3D, it is directly concluded.
- If the payment transaction is successfully concluded, successful result values are posted to the "successUrl" page and redirected.
- If the transaction fails, failed transaction information is posted to the "failURL" page.
| Name | Type | Description | Required | Example Value |
|---|---|---|---|---|
agentCode | string | If the transaction is made through a sub-dealer, you can send your sub-dealer's code with this value. | Optional | 7683323 |
amount | decimal | Payment amount. Decimal separator should be . (dot). | Required | 1280.10 |
bin | string | If desired, you can only accept transactions from specific card bins. (First 6 digits of the card.) | Optional | 413278|521089 |
cardcampaign | string | You can run campaigns for Visa, Master Cards. Send 4 for Visa, 5 for MasterCard. | Optional | 4 (Visa) / 5 (MC) |
cardHolderIP | string | The IP address of the card holder. | Required | 37.135.23.122 |
clientRefCode | string | Your own reference number. (No Turkish characters. Max 1024 chars.) | Required | 5231As-FE2A36 |
currencyCode | string | If not sent, transaction is in TL. Send 840 for USD, 978 for EUR. | Optional | 949 |
customerKey | string | Must be sent to enable card storage with the hosted payment page. | Optional | 13813813813 |
detail | string | If sent as "true", additional customer info fields appear on the hosted payment page. | Optional | true |
ECOMM_PLATFORM | string | If developing B2B software, you can write your platform name. | Optional | Cetvel |
failUrl | string | Failed transaction results are posted here. | Required | https://domain.com/fail |
hashDataV2 | string | Security hash value. See hash calculation page for details. | Required | sUZl2nWw... |
instalments | string | Installment count. 1 = single payment. If empty, default installment settings apply. | Optional | 2 |
language | string | Language option. "en" English, "ru" Russian. Default is Turkish. | Optional | en |
MerchantCustomerNo | string | Your dealer or sub-merchant number. Searchable from your panel. | Optional | 93423410 |
rnd | string | You need to send the transaction date with DateTime.Now. | Required | 09-08-2021 15:24:22 |
second | string | You can post the remaining cart time in seconds. A countdown is shown. | Optional | 600 |
successUrl | string | Successful transaction results are posted here. | Required | https://domain.com/success |
sx | string | Login code required for Web Service (Token). | Required | 114488219|SjEH1wb... |
transactionType | string | "SALES" for sales or "PRESALES" for provision. | Required | SALES |
use3D | string | If "true", forces 3D Secure. If empty, current limit applies. | Required | true |