Card Storage

CONNECTION ADDRESSES

Real Environment

It will also be forwarded.

Test Environment

https://test-dmz.param.com.tr/out.ws/service_ks.asmx?op=KS_Kart_Ekle

Test Parameter Value
CLIENT_CODE 10738
CLIENT_USERNAME Test
CLIENT_PASSWORD Test
GUID 0c13d406-873b-403b-9c09-a5766840d98c


  • Card Storage
  • Card Storage Payment
  • Card Storage List
  • Pre-Authorization with Stored Card
  • Delete Stored Card
  • Card Verification
Method Name: KS_Kart_Ekle

Used for credit card storage

Parameter Required Type Length Description
G Yes Object - ST_WS_Guvenlik Object
GUID Yes String - GUID Value
KK_Sahibi Yes String 150 Name and Surname of Credit Card Holder
KK_No Yes String 16 Credit Card Number
KK_SK_Ay Yes String 2 Credit Card Expiry Month
KK_SK_Yil Yes String 4 Credit Card Expiry Year
KK_Kart_Adi No String 150 Name of the Credit Card to be Stored, Optional
KK_Islem_ID No String 200 Unique ID value to be sent to you for the stored credit card
Parameter Type Length Description
Sonuc Integer 1 Result Value
Sonuc_Str String 150 Result Description, If Result Parameter > 0 then Operation Successful, otherwise unsuccessful
KS_GUID String 36 GUID value for card storage
<?xml version="1.0" encoding="utf-8"?> <soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"> <soap:Body>
<KS_Kart_Ekle xmlns="https://turkpara.com.tr/">
<G>
<CLIENT_CODE>10738</CLIENT_CODE>
<CLIENT_USERNAME>Test</CLIENT_USERNAME>
<CLIENT_PASSWORD>Test</CLIENT_PASSWORD>
</G>
<GUID>0c13d406-873b-403b-9c09-a5766840d98c</GUID>
<KK_Sahibi>albert</KK_Sahibi>
<KK_No>4546711234567894</KK_No>
<KK_SK_Ay>12</KK_SK_Ay>
<KK_SK_Yil>26</KK_SK_Yil>
<KK_Kart_Adi>Albert</KK_Kart_Adi>
<KK_Islem_ID></KK_Islem_ID>
</KS_Kart_Ekle>
</soap:Body>
</soap:Envelope>
<?xml version="1.0" encoding="utf-8"?> <soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<soap:Body>
<KS_Kart_EkleResponse xmlns="https://turkpara.com.tr/">
<KS_Kart_EkleResult>
<Sonuc>1</Sonuc>
<Sonuc_Str>Başarılı</Sonuc_Str>
<KS_GUID>fdf1bd44-eddf-40ae-a42b-da31a4559af0</KS_GUID>
</KS_Kart_EkleResult>
</KS_Kart_EkleResponse>
</soap:Body>
</soap:Envelope>
Method Name: KS_Tahsilat

It is used to collect from a stored credit card.

Parameter Required Type Length Description
G Yes Object - ST_WS_Security Object
GUID Yes String 36 ParamPOS GUID value
KS_GUID Yes String 36 GUID value returned from KS_Kart_Add method
CVV No String 3 Must be entered for 3D transactions. Can be left blank for Nonsecure transactions.
KK_Sahibi_GSM Yes String 10 Credit Card Holder's GSM Number, without leading 0 (5xxxxxxxxx)
Hata_URL Yes String 250 Page address to redirect if payment fails
Basarili_URL Yes String 250 Page address to redirect if payment is successful
Siparis_ID Yes String - Unique ID specific to the order. If you have sent this value before, the system assigns a new Siparis_ID. This Siparis_ID is returned after the transaction.
Siparis_Aciklama No String 250 Description of the order
Taksit Yes Integer 2 Number of installments selected. Send 1 for single payment.
Islem_Tutar Yes String - Transaction amount
Toplam_Tutar Yes String - Total order amount including commission, (only in comma-separated cents format 1000.50)
Islem_Guvenlik_Tip Yes String 2 Send NS (NonSecure) or 3D
Islem_ID No String - Unique ID sent to you in addition to the Order ID, optional
IPAdr Yes String 256 IP Address
Ref_URL No String 256 URL of the page where the payment is made
Data1 No String 250 Extra Field 1
Data2 No String 250 Extra Field 2
Data3 No String 250 Extra Field 3
Data4 No String 250 Extra Field 4
KK_Islem_ID No String 200 Unique ID value transmitted to the stored Credit Card
Parameter Type Length Description
Sonuc Integer 1 Result Value
Sonuc_Str String 150 Result Description, If Result Parameter > 0, the operation is successful; otherwise, it fails.
UCD_URL String 150 URL information, For Nonsecure transactions, this field returns "NONSECURE".
Islem_ID Long - 3D URL Transaction ID information. For Nonsecure transactions, it returns the value "Dekont_ID".
<?xml version="1.0" encoding="utf-8"?> <soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"> <soap:Body>
<KS_Tahsilat xmlns="https://turkpara.com.tr/">
<G>
<CLIENT_CODE>10738</CLIENT_CODE>
<CLIENT_USERNAME>Test</CLIENT_USERNAME>
<CLIENT_PASSWORD>Test</CLIENT_PASSWORD>
</G>
<GUID>0c13d406-873b-403b-9c09-a5766840d98c</GUID>
<KS_GUID>0af56e91-5737-4268-bd86-57965b88d140</KS_GUID>
<CVV>000</CVV>
<KK_Sahibi_GSM>5551231212</KK_Sahibi_GSM>
<Hata_URL>http://localhost:62361/turkpos.api/Sonuc.aspx</Hata_URL>
<Basarili_URL>http://localhost:62361/turkpos.api/Sonuc.aspx</Basarili_URL>
<Siparis_ID>sipariş1</Siparis_ID>
<Siparis_Aciklama>string</Siparis_Aciklama>
<Taksit>1</Taksit>
<Islem_Tutar>100,00</Islem_Tutar>
<Toplam_Tutar>100,00</Toplam_Tutar>
<Islem_Guvenlik_Tip>string</Islem_Guvenlik_Tip>
<Islem_ID>string</Islem_ID>
<IPAdr>127.0.0.1</IPAdr>
<Ref_URL>string</Ref_URL>
<Data1>string</Data1>
<Data2>string</Data2>
<Data3>string</Data3>
<Data4>string</Data4>
<KK_Islem_ID>string</KK_Islem_ID>
</KS_Tahsilat>
</soap:Body>
</soap:Envelope>
<?xml version="1.0" encoding="utf-8"?> <soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<soap:Body>
<KS_TahsilatResponse xmlns="https://turkpara.com.tr/">
<KS_TahsilatResult>
<Islem_ID>6004507613</Islem_ID>
<UCD_URL>https://test-pos.param.com.tr:4443/3D_Secure/AkilliKart_3DPay_EST.aspx?rURL=TURKPOS_3D_TRAN&SID=6004507613</UCD_URL>
<Sonuc>1</Sonuc>
<Sonuc_Str>İşlem Başarılı</Sonuc_Str>
</KS_TahsilatResult>
</KS_TahsilatResponse>
</soap:Body>
</soap:Envelope>

Islem_Guvenlik_Tip = "NS" indicates that the operation was successful according to the following rule.

Sonuc > 0 and UCD_URL=”Nonsecure” and Islem_ID > 0 the operation is successful.

POST Parameters:

Parameter Description
TURKPOS_RETVAL_Sonuc Result value
TURKPOS_RETVAL_Sonuc_Str Result description
TURKPOS_RETVAL_GUID Merchant's key
TURKPOS_RETVAL_Islem_Tarih Transaction date
TURKPOS_RETVAL_Dekont_ID Receipt number
TURKPOS_RETVAL_Tahsilat_Tutari Amount collected from the customer
TURKPOS_RETVAL_Odeme_Tutari Net amount. It is the amount collected minus the commission.
TURKPOS_RETVAL_Siparis_ID Unique Siparis_ID of the transaction sent to the service
TURKPOS_RETVAL_Islem_ID Islem_ID sent to the service
TURKPOS_RETVAL_Ext_Data Concatenated form of Data1, Data2, Data3, Data4, Data5 parameters separated by "|". Ext_Data = Data1 & "|" & Data2 & "|" & Data3 & "|" & Data4 & "|" & Data5

If TURKPOS_RETVAL_Sonuc < 0, TURKPOS_RETVAL_Dekont_ID returns "0". TURKPOS_RETVAL_Dekont_ID value greater than "0" indicates a successful debit transaction from the credit card.

If Sonuc > 0, UCD_URL is checked for equality to 'NONSECURE'. If they are equal, the transaction ends. Islem_ID value is the Dekont No. For a successful NonSecure transaction, Sonuc > 0, Islem_ID > 0, and UCD_URL='NONSECURE' must hold true. Otherwise, the transaction fails. In case of an error in the NONSECURE transaction, Sonuc_Str returns the error message from the bank.
If UCD_URL <> 'NONSECURE', it is treated like a 3D transaction.

Security

Services must be accessed over HTTPS protocol in a real environment.
To perform transactions, the institution's internet exit IP address or IP blocks, website address should be provided, and necessary definitions must be made by us.

and necessary definitions should be made by us.

Method Name: KS_Kart_Liste

This method is used to list stored cards.

Parameter Required Type Length Description
G * Object - ST_WS_Guvenlik Object
GUID * String 36 Merchant Key
KK_Kart_Adi * String - Name of the stored card
KK_Islem_ID String - Unique ID of the stored card (Optional)
Parameter Type Length Description
Sonuc Integer 1 Result Value
Sonuc_Str String 150 Result Description, If Result Parameter > 0, the transaction is successful; otherwise, it fails.
DT_Bilgi Object - Returns the list of stored cards
<?xml version="1.0" encoding="utf-8"?> <soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"> <soap:Body>
<KS_Kart_Liste xmlns="https://turkpara.com.tr/">
<G>
<CLIENT_CODE>10738</CLIENT_CODE>
<CLIENT_USERNAME>Test</CLIENT_USERNAME>
<CLIENT_PASSWORD>Test</CLIENT_PASSWORD>
</G>
<GUID>0c13d406-873b-403b-9c09-a5766840d98c</GUID>
<KK_Kart_Adi>Albert</KK_Kart_Adi>
<KK_Islem_ID></KK_Islem_ID>
</KS_Kart_Liste>
</soap:Body>
</soap:Envelope>
<?xml version="1.0" encoding="utf-8"?> <soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<soap:Body>
<KS_Kart_ListeResponse xmlns="https://turkpara.com.tr/">
<KS_Kart_ListeResult>
<Sonuc>1</Sonuc>
<Sonuc_Str>Başarılı</Sonuc_Str>
<DT_Bilgi>
<xs:schema id="NewDataSet" xmlns="" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:msdata="urn:schemas-microsoft-com:xml-msdata">
<xs:element name="NewDataSet" msdata:IsDataSet="true" msdata:MainDataTable="Temp" msdata:UseCurrentLocale="true">
<xs:complexType>
<xs:choice minOccurs="0" maxOccurs="unbounded">
<xs:element name="Temp">
<xs:complexType>
<xs:sequence>
<xs:element name="ID" type="xs:int" minOccurs="0" />
<xs:element name="KK_GUID" msdata:DataType="System.Guid, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" type="xs:string" minOccurs="0" />
<xs:element name="Tarih" type="xs:dateTime" minOccurs="0" />
<xs:element name="KK_No" type="xs:string" minOccurs="0" />
<xs:element name="KK_Tip" type="xs:string" minOccurs="0" />
<xs:element name="KK_Banka" type="xs:string" minOccurs="0" />
<xs:element name="KK_Marka" type="xs:string" minOccurs="0" />
<xs:element name="Kart_Adi" type="xs:string" minOccurs="0" />
<xs:element name="KK_Hash" type="xs:string" minOccurs="0" />
<xs:element name="KK_KD" type="xs:string" minOccurs="0" />
<xs:element name="KK_SK" type="xs:dateTime" minOccurs="0" />
<xs:element name="Data2" type="xs:int" minOccurs="0" />
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:choice>
</xs:complexType>
</xs:element>
</xs:schema>
<diffgr:diffgram xmlns:msdata="urn:schemas-microsoft-com:xml-msdata" xmlns:diffgr="urn:schemas-microsoft-com:xml-diffgram-v1">
<NewDataSet xmlns="">
<Temp diffgr:id="Temp1" msdata:rowOrder="0">
<ID>20014905</ID>
<KK_GUID>fdf1bd44-eddf-40ae-a42b-da31a4559af0</KK_GUID>
<Tarih>2021-02-15T17:30:21.817+03:00</Tarih>
<KK_No>454671</KK_No>
<KK_Tip>VISA</KK_Tip>
<KK_Banka>T.C. ZİRAAT BANKASI A.Ş.</KK_Banka>
<KK_Marka>Maximum</KK_Marka>
<Kart_Adi>Albert</Kart_Adi>
<KK_Hash>g09JP5zMY+9CdHcXPzz1qM8Ekveie65NAULKo31KzNLali2SvkJureZAHYxrHrxAGhz4DOSV2zEQXtCVFF8Iog==</KK_Hash>
<KK_KD>Kredi Kartı</KK_KD>
<KK_SK>2026-12-31T00:00:00+03:00</KK_SK>
<Data2>0</Data2>
</Temp>
<Temp diffgr:id="Temp2" msdata:rowOrder="1">
<ID>20014900</ID>
<KK_GUID>12ed0b4d-b49c-4c94-92e1-0d94bbe41eb7</KK_GUID>
<Tarih>2021-02-15T16:19:16.737+03:00</Tarih>
<KK_No>454671</KK_No>
<KK_Tip>VISA</KK_Tip>
<KK_Banka>T.C. ZİRAAT BANKASI A.Ş.</KK_Banka>
<KK_Marka>Maximum</KK_Marka>
<Kart_Adi>Albert</Kart_Adi>
<KK_Hash>g09JP5zMY+9CdHcXPzz1qM8Ekveie65NAULKo31KzNLali2SvkJureZAHYxrHrxAGhz4DOSV2zEQXtCVFF8Iog==</KK_Hash>
<KK_KD>Kredi Kartı</KK_KD>
<KK_SK>2026-12-31T00:00:00+03:00</KK_SK>
<Data2>0</Data2>
</Temp> <Temp diffgr:id="Temp3" msdata:rowOrder="2">
<ID>20014899</ID>
<KK_GUID>bf3c4949-47f3-4883-b90e-eec8bd6f4b12</KK_GUID>
<Tarih>2021-02-15T16:13:05.977+03:00</Tarih>
<KK_No>454671</KK_No>
<KK_Tip>VISA</KK_Tip>
<KK_Banka>T.C. ZİRAAT BANKASI A.Ş.</KK_Banka>
<KK_Marka>Maximum</KK_Marka>
<Kart_Adi>Albert</Kart_Adi>
<KK_Hash>g09JP5zMY+9CdHcXPzz1qM8Ekveie65NAULKo31KzNLali2SvkJureZAHYxrHrxAGhz4DOSV2zEQXtCVFF8Iog==</KK_Hash>
<KK_KD>Kredi Kartı</KK_KD>
<KK_SK>2026-12-31T00:00:00+03:00</KK_SK>
<Data2>0</Data2>
</Temp>
</NewDataSet>
</diffgr:diffgram>
</DT_Bilgi>
</KS_Kart_ListeResult>
</KS_Kart_ListeResponse>
</soap:Body>
</soap:Envelope>

DT_Bilgi Object

Parameter Type Length Description
ID String - Stored Card ID
KK_GUID String 36 Stored Card GUID value
Tarih String 10 Storage Date
KK_No String 16 Credit Card BIN Code
KK_Tip String - Card Type
KK_Banka String - Card Bank
KK_Marka String - Card Brand
Kart_Adi String - Card Name
KK_Hash String - Credit Card Hash Value
KK_KD String - Card Category
KK_SK String 6 Credit Card Expiry Date

TP_Islem_Odeme_OnProv_WKS Hash Formula

                        
                Dim Transaction_Security_Str$ = CLIENT_CODE & GUID & Islem_Tutar & Toplam_Tutar & Siparis_ID & Hata_URL & Basarili_URL 
                Dim Transaction_Hash$ = SHA2B64(Transaction_Security_Str)

Method Name: TP_Islem_Odeme_OnProv_WKS

It is used to make pre-authorization transaction with stored card.

Parameter Required Type Length Description
G Yes Object - ST_WS_Security Object
GUID Yes String 36 Merchant's Key
KK_GUID Yes String 36 Stored Card GUID information
KS_Kart_No Yes String 36 Enter GUID information
KK_Sahibi_GSM Yes String 10 Credit Card Holder GSM No, without leading 0 (5xxxxxxxxx)
Hata_URL Yes String 256 Page address to redirect if payment fails
Basarili_URL Yes String 256 Page address to redirect if payment succeeds
Siparis_ID Yes String 50 Unique ID specific to the order. If you have sent this value before, the system assigns a new Order_ID. The system returns this Order_ID after the transaction process.
Siparis_Aciklama Yes String 250 Description of the order
Islem_Tutar Yes String - Order Amount, (only in decimal format like 1000.50)
Toplam_Tutar Yes String - Order Amount including Commission, (only in decimal format like 1000.50)
Islem_Hash Yes String - Transaction Hash Value
Islem_Guvenlik_Tip Yes String - NS (NonSecure) or 3D is sent
Islem_ID No String - Unique ID except for Order ID, optional
IPAdr Yes String 50 IP Address
Ref_URL No String 256 URL of the page where the payment is made
Data1 No String 250 Extra Field 1
Data2 No String 250 Extra Field 2
Data3 No String 250 Extra Field 3
Data4 No String 250 Extra Field 4
Data5 No String 250 Extra Field 5
Parameter Type Length Description
Sonuc Integer - Operation result
Sonuc_Str String - Operation result description
Islem_ID Long - SID Value
Islem_GUID String - Transaction GUID Value
UCD_URL String - Bank 3D HTML content
UCD_MD String - Bank 3D Pre-Verification MD value
Banka_Sonuc_Kod String - Bank Transaction ID value
Siparis_ID String - Order ID value
Banka_Sonuc_Kod Integer - Code returned by the bank
<?xml version="1.0" encoding="utf-8"?> <soap12:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"> <soap:Body>
<TP_Islem_Odeme_OnProv_WKS xmlns="https://turkpos.com.tr/">
<G>
<CLIENT_CODE>10738</CLIENT_CODE>
<CLIENT_USERNAME>test</CLIENT_USERNAME>
<CLIENT_PASSWORD>test</CLIENT_PASSWORD>
</G>
<GUID>0c13d406-873b-403b-9c09-a5766840d98c</GUID>
<KK_GUID>29a768aa-c8ab-4868-ba34-de172fe5274a</KK_GUID>
<KS_Kart_No>0c13d406-873b-403b-9c09-a5766840d98c</KS_Kart_No>
<KK_Sahibi_GSM>5454845>
<Hata_URL>www.ornek.com.tr</Hata_URL>
<Basarili_URL>www.ornek.com.tr</Basarili_URL>
<Siparis_ID>147963</Siparis_ID>
<Siparis_Aciklama>string</Siparis_Aciklama>
<Islem_Tutar>100,00</Islem_Tutar>
<Toplam_Tutar>100,00</Toplam_Tutar>
<Islem_Hash>VIwkKAhPVr0r05Ze1zgCLGc0AV0=</Islem_Hash>
<Islem_Guvenlik_Tip>3D</Islem_Guvenlik_Tip>
<Islem_ID>sipariş11</Islem_ID>
<IPAdr>127.0.0.1</IPAdr>
<Ref_URL>string</Ref_URL>
<Data1></Data1>
<Data2></Data2>
<Data3></Data3>
<Data4></Data4>
<Data5></Data5>
</TP_Islem_Odeme_OnProv_WKS>
</soap:Body>
</soap:Envelope>

Sonuç Parametreleri Örnek: NS li işlemler için

<?xml version="1.0" encoding="utf-8"?> <soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<soap:Body>
<TP_Islem_Odeme_OnProv_WKSResponse xmlns="https://turkpos.com.tr/">
<TP_Islem_Odeme_OnProv_WKSResult>
<Sonuc>1</Sonuc>
<Sonuc_Str>İşlem Başarılı</Sonuc_Str>
<Islem_ID>6005034652</Islem_ID>
<Islem_GUID>c0f56ee7-a1ae-4544-900e-0f2d4329bb8b</Islem_GUID>
<UCD_URL>https://test-pos.param.com.tr:4443/3D_Secure/AkilliKart_3DPay_EST.aspx?rURL=TURKPOS_3D_TRAN &SID=6005034652</UCD_URL>
<Islem_GUID>e1d74247-e1af-42a6-9936-3af584eb62bd</Islem_GUID>
<Banka_Sonuc_Kod>0</Banka_Sonuc_Kod>
<Siparis_ID>147963</Siparis_ID>
</TP_Islem_Odeme_OnProv_WKSResult>
</TP_Islem_Odeme_OnProv_WKSResponse>
</soap:Body>
</soap:Envelope>

Method Name: KS_Kart_Sil

This method is used to delete stored cards.

Parameter Required Type Length Description
G * Object - ST_WS_Guvenlik Object
KS_GUID * String 36 GUID value of the stored card
KK_Islem_ID * String 200 Unique ID value to be provided by you for the stored credit card

G Object:

Parameter Required Type Length Description
CLIENT_CODE * Integer 5 Terminal ID, provided by us.
CLIENT_USERNAME * String max 16 Username, provided by us.
CLIENT_PASSWORD * String max 11 Password, provided by us.
Parameter Type Length Description
Sonuc Integer 1 Result Value
Sonuc_Str String 150 Result Description, If Result Parameter > 0, Operation Successful; otherwise, failed.
<?xml version="1.0" encoding="utf-8"?> <soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"> <soap:Body>
<KS_Kart_Sil xmlns="https://turkpara.com.tr/">
<G>
<CLIENT_CODE>10738</CLIENT_CODE>
<CLIENT_USERNAME>Test</CLIENT_USERNAME>
<CLIENT_PASSWORD>Test</CLIENT_PASSWORD>
</G>
<KS_GUID>7647f35d-7f37-4f83-bdc6-37c1e18fcd96</KS_GUID>
<KK_Islem_ID>1014</KK_Islem_ID>
</KS_Kart_Sil>
</soap:Body>
</soap:Envelope>
<?xml version="1.0" encoding="utf-8"?> <soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<soap:Body>
<KS_Kart_SilResponse xmlns="https://turkpara.com.tr/">
<KS_Kart_SilResult>
<Sonuc>1</Sonuc>
<Sonuc_Str>Başarılı</Sonuc_Str>
</KS_Kart_SilResult>
</KS_Kart_SilResponse>
</soap:Body>
</soap:Envelope>
Method Name: TP_KK_Verify

Used to provide card authentication.

Parameter Required Type Length Description
G Yes Object - ST_WS_Guvenlik Object
KK_No Yes String 16 Credit Card Number
KK_SK_Ay Yes String 2 2-digit Expiry Month
KK_SK_Yil Yes String 4 4-digit Expiry Year
KK_CVC Yes String 3 CVC Code
Return_URL No String 256 URL where result post parameters are returned.
Data1 No String 250 Extra Data 1
Data2 No String 250 Extra Data 2
Data3 No String 250 Extra Data 3
Data4 No String 250 Extra Data 4
Data5 No String 250 Extra Data 5
Parameter Type Length Description
Islem_ID Long - SID Value
UCD_URL String - 3D URL
Sonuc Integer - Transaction result
Sonuc_Str String - Transaction result description
Banka_Sonuc_Kod Integer - Bank's returned code
<?xml version="1.0" encoding="utf-8"?> <soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"> <soap:Body>
<TP_KK_Verify xmlns="https://turkpos.com.tr/">
<G>
<CLIENT_CODE>10738</CLIENT_CODE>
<CLIENT_USERNAME>Test</CLIENT_USERNAME>
<CLIENT_PASSWORD>Test</CLIENT_PASSWORD>
</G>
<KK_No>4546711234567894</KK_No>
<KK_SK_Ay>12</KK_SK_Ay>
<KK_SK_Yil>26</KK_SK_Yil>
<KK_CVC>000</KK_CVC>
<Return_URL></Return_URL>
<Data1></Data1>
<Data2></Data2>
<Data3></Data3>
<Data4></Data4>
<Data5></Data5>
</TP_KK_Verify>
</soap:Body>
</soap:Envelope>
<?xml version="1.0" encoding="utf-8"?> <soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<soap:Body>
<TP_KK_VerifyResponse xmlns="https://turkpos.com.tr/">
<TP_KK_VerifyResult>
<Islem_ID>1071375</Islem_ID>
<UCD_URL>https://pos.param.com.tr/Tahsilat/3D_Secure/AkilliKart_3DPay_EST_Verify.aspx?I=Go2dBU2YWi35ulYQ3GN8nw==</UCD_URL>
<Sonuc>1</Sonuc>
<Sonuc_Str>Başarılı</Sonuc_Str>
<Banka_Sonuc_Kod>0</Banka_Sonuc_Kod>
</TP_KK_VerifyResult>
</TP_KK_VerifyResponse>
</soap:Body>
</soap:Envelope>

If the Result parameter of the TP_KK_Verify method is greater than "0", redirect to the CD_URL parameter to start the 3D Secure Verification process. If the credit card verification process is successful or unsuccessful, POST is provided to Return_URL values.

Post Parameters

Parameter Type Length Description
KK_VERIFY_Result String - Transaction result
KK_VERIFY_Result_Str String - Transaction result description
KK_VERIFY_Data1 String 250 Extra Data 1
KK_VERIFY_Data2 String 250 Extra Data 2
KK_VERIFY_Data3 String 250 Extra Data 3
KK_VERIFY_Data4 String 250 Extra Data 4
KK_VERIFY_Data5 String 250 Extra Data 5