BKM Express / Masterpass

TP_Islem_Odeme_BKM Hash Formul

    
                        
                Dim Security_Str$ = CLIENT_CODE & GUID & Amount & Order_ID & Error_URL & Success_URL
                Dim Islem_Hash$ = SHA2B64(Security_Str)
    
  • Payment with BKM Express
  • Payment with Masterpass
Method Name: TP_Islem_Odeme_BKM

This method initiates the payment process via BKM Express. Redirect_URL parameter is used to redirect to the returned outcome, and the payment process begins by logging into BKM Express.

Parameter Required Type Lenght Description
G Yes Object - ST_WS_Guvenlik Object
GUID Yes String 36 Key belonging to Merchant
Customer_Info No String 100 Merchant's customer name surname/company name
Customer_GSM Yes String 10 Merchant's customer GSM No, without leading 0 (5xxxxxxxxx)
Error_URL Yes String 250 URL of the page to redirect in case of payment failure
Success_URL Yes String 250 URL of the page to redirect in case of successful payment
Order_ID Yes String - Unique ID specific to the order. If you have previously sent this value, the system will assign a new Order_ID. This Order_ID is returned after the transaction.
Order_Description No String 250 Description of the order
Amount Yes String - Order Amount, (in comma-separated decimal format, e.g., 1000.50)
Payment_Hash Yes String - Payment Hash Value
Transaction_ID No String - Unique ID excluding Order ID except singular ID, optional.
IPAddress Yes String 250 IP Adress
Referrer_URL No String 256 URL of the page where the payment took place.
Parametre Type Lenght Description
Response_Code Integer - Outcome of the transacition
Response_Message String - Description of transaction outcome
Redirect_URL String - BKM Express URL
<?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_BKM 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>
<Customer_Info></Customer_Info>
<Customer_GSM>5551231212</Customer_GSM>
<Error_URL>http://localhost:62361/turkpos.api/Sonuc.aspx</Error_URL>
<Success_URL>http://localhost:62361/turkpos.api/Sonuc.aspx</Success_URL>
<Order_ID>sipariş1</Order_ID>
<Order_Description></Order_Description>
<Amount>100,00</Amount>
<Payment_Hash>4HaFjeEYpcVMQYgq94lxuYWHAV8=</Payment_Hash>
<Transaction_ID></Transaction_ID>
<IPAddress>127.0.0.1</IPAddress>
<Referrer_URL></Referrer_URL>
</TP_Islem_Odeme_BKM>
</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_BKMResponse xmlns="https://turkpos.com.tr/">
<TP_Islem_Odeme_BKMResult>
<Redirect_URL>https://pos.param.com.tr/Tahsilat/3D_Secure/AkilliKart_3DPay_BKM.aspx?D=7R1zVm9su53NNw1x7m195w==</Redirect_URL>
<Response_Code>1</Response_Code>
<Response_Message>Başarılı</Response_Message>
</TP_Islem_Odeme_BKMResult>
</TP_Islem_Odeme_BKMResponse>
</soap:Body>
</soap:Envelope>

Response_Code parameter that you will get from the ST_TP_Islem_Odeme_BKM object If it is greater than "0", redirect to the Redirect_URL parameter to initiate the Payment process with BKM Express. In case of success or failure of the transaction, POST is provided to Hata_URL or Basarili_URL values.

POST Parameters

Parameter Description
TURKPOS_RETVAL_Sonuc Result value
TURKPOS_RETVAL_Sonuc_Str Result description
TURKPOS_RETVAL_GUID Merchant key belonging to the member merchant
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 amount.
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_Banka_Sonuc_Kod Code returned by the bank indicating an error.

If TURKPOS_RETVAL_Sonuc < 0 TURKPOS_RETVAL_Dekont_ID returns "0". If TURKPOS_RETVAL_Dekont_ID value is greater than "0", it means the credit card transaction has been completed.

ParamPos is integrated into MasterPass systems like a bank by MasterPass. To receive payments from your customers' cards registered in MasterPass via ParamPos;


- Your MasterPass integration must be completed.
- You must transmit your ParamPos Integration Information to MasterPass.
- According to your request, MasterPass will be able to redirect the cards of the banks you have determined to ParamPos.