Payment with Foreign Currency

TP_Islem_Odeme_WD 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_WD

This method is used to make transactions in foreign currency.

This method only works with foreign cards.

Parameter Required Type Lenght Description
G Yes Object - ST_WS_Guvenlik Object
GUID Yes String 36 Key of the Merchant
Doviz_Kodu Yes Integer - Doviz_Kodu Credit
1000 TurkPara - TRL
1001 TurkPara - USD
1002 TurkPara - EUR
1003 Turkpara - GBP
KK_Sahibi Yes String 100 Credit Card Holder
KK_No Yes String 16 Credit Card Number
KK_SK_Ay Yes String 2 two-digit expiration (month)
KK_SK_Yil Evet String 4 4-digit Expiration (Year)
KK_CVC Yes String 3 CVC Code
KK_Sahibi_GSM Yes String 10 Credit Card Holder GSM Number, without leading 0 (5xxxxxxxxx)
Hata_URL Yes String 256 Page address to redirect to if the checkout fails
Basarili_URL Yes String 256 Page url to be redirected if the payment is successful
Siparis_ID Evet 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
Siparis_Aciklama Yes String 250 Description of the order
Islem_Tutar Yes String - Order Amount, (only in comma penny format 1000,50)
Toplam_Tutar Yes String - Order Amount Including Commission, (only in comma penny format 1000,50)
Islem_Hash Yes String - Transaction Hash Value
Islem_Guvenlik_Tip Yes String - Sent NS (NonSecure) or 3D
Islem_ID No String - Unique ID other than Order ID of the transaction, optional.
IPAdr Yes String 50 IP Adress
Ref_URL No String 256 URL of the payment page
Data1 No String 250 Extra space 1
Data2 No String 250 Extra space 2
Data3 No String 250 Extra space 3
Data4 No String 250 Extra space 4
Data5 No String 250 Extra space 5
Parameter Type Lenght Description
Sonuc Integer - Transaction result
Sonuc_Str String - Process result description
Islem_ID Long - SID Value
UCD_URL Long - 3D URL
Banka_Sonuc_Kod Integer - The code the bank returns
<?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_Islem_Odeme_WD xmlns="https://turkpos.com.tr/">
<G>
<CLIENT_CODE>10738</CLIENT_CODE>
<CLIENT_USERNAME>Test</CLIENT_USERNAME>
<CLIENT_PASSWORD>Test</CLIENT_PASSWORD>
</G>
<Doviz_Kodu>1001</Doviz_Kodu>
<GUID>0c13d406-873b-403b-9c09-a5766840d98c</GUID>
<KK_Sahibi>test</KK_Sahibi>
<KK_No>4546711234567894</KK_No>
<KK_SK_Ay>12</KK_SK_Ay>
<KK_SK_Yil>26</KK_SK_Yil>
<KK_CVC>000</KK_CVC>
<KK_Sahibi_GSM>5551231212</KK_Sahibi_GSM>
<Hata_URL>https://dev.param.com.tr/tr</Hata_URL>
<Basarili_URL>https://dev.param.com.tr/tr</Basarili_URL>
<Siparis_ID>siparis3</Siparis_ID>
<Siparis_Aciklama>string</Siparis_Aciklama>
<Islem_Tutar>100,00</Islem_Tutar>
<Toplam_Tutar>100,00</Toplam_Tutar>
<Islem_Hash>fs8n4uuUj37DXZJvvHfnj1cFUYg=</Islem_Hash>
<Islem_Guvenlik_Tip>3D</Islem_Guvenlik_Tip>
<Islem_ID>125</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>
<Data5>string</Data5>
</TP_Islem_Odeme_WD>
</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_Islem_Odeme_WDResponse xmlns="https://turkpos.com.tr/">
<TP_Islem_Odeme_WDResult>
<Islem_ID>1039844991</Islem_ID>
<UCD_URL>https://pos.param.com.tr/Tahsilat/3D_Secure/AkilliKart_3DPay_EST_Doviz.aspx?rURL=TURKPOS_3D_TRAN&SID=7d042480-556b-46ba-8a74-9ffdb7d40e62</UCD_URL>
<Sonuc>1</Sonuc>
<Sonuc_Str>İşlem Başarılı</Sonuc_Str>
<Banka_Sonuc_Kod>0</Banka_Sonuc_Kod>
</TP_Islem_Odeme_WDResult>
</TP_Islem_Odeme_WDResponse>
</soap:Body>
</soap:Envelope>

Parameter Description
TURKPOS_RETVAL_Sonuc Result value
TURKPOS_RETVAL_Sonuc_Str Result Description
TURKPOS_RETVAL_GUID GUID Information
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. The amount collected minus the commission fee.
TURKPOS_RETVAL_Siparis_ID Unique Order_ID for the transaction sent to the service
TURKPOS_RETVAL_Islem_ID Transaction ID sent to the service
TURKPOS_RETVAL_Ext_Data The concatenated form of the parameters Data1, Data2, Data3, Data4, Data5 in the method. Ext_Data = Data1 & "|" & Data2 & "|" & Data3 & "|" & Data4 & "|" & Data5
TURKPOS_RETVAL_Banka_Sonuc_Kod The code returned by the bank error.
TURKPOS_RETVAL_KK_No Credit card number (First 6, last 4)