Co-Payment / iFrame

  • Co-Payment
  • iFrame

You can create a payment link with a shared payment page and receive payments from your customers through an interface. When you run the To_Pre_Encrypting_OOS service to set up the payment interface, a string value is returned in the result object within the response.

You can create the shared payment page by adding this string value to the link https://test-pos.param.com.tr/default.aspx?s= for the test environment, and to the link https://pos.param.com.tr/Tahsilat/Default.aspx?s= for the production environment.

After the payment transaction is completed, the payment result is sent as a post request to the address specified in the Return_URL parameter.

During test transactions, you can use our test cards.

Parameters Required Type Lenght Description
G Yes Object - ST_WS_Guvenlik Object
GUID Yes String GUID value to be obtained from İŞube.
Borclu_Kisi_TC No String 11 The Turkish ID number of the person making the payment is optional and can be left blank.
Borclu_Aciklama Yes String 200 Description of the amount to be paid. If you want this field to be editable, you should prefix it with "e|", and if you want it to be readonly, you should prefix it with "r|".
Borclu_Tutar Yes String Amount to be received.
Borclu_GSM No String 10 Phone number
Borclu_Odeme_Tip Yes String You can pass "Other" by default. If you want this field to be editable, you should prefix it with "e|", and if you want it to be readonly, you should prefix it with "r|".
Borclu_AdSoyad Yes String 100 First and last name of the person making the payment. If you want this field to be editable, you should prefix it with "e|", and if you want it to be readonly, you should prefix it with "r|".
Return_URL Yes String URL to return the result after checkout
Islem_ID Yes String Unique ID or Key belonging to the lawyer for whom the payment will be made, as registered in your system regarding the payment transaction.
Taksit Yes Integer 1 If it is 0, all installments will be listed. If it is greater than 0, only that installment option will be listed.
Terminal_ID Yes Integer 5 The terminal number to be provided by us.
Parameters Type Lenght Description
TO_Pre_Encrypting_OOSResult String -
<?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>
<TO_Pre_Encrypting_OOS xmlns="https://turkodeme.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>
<Borclu_Kisi_TC></Borclu_Kisi_TC>
<Borclu_Aciklama>r|açıklama</Borclu_Aciklama>
<Borclu_Tutar>r|10,00</Borclu_Tutar>
<Borclu_GSM>r|5555555555</Borclu_GSM>
<Borclu_Odeme_Tip>r|</Borclu_Odeme_Tip>
<Borclu_AdSoyad>test</Borclu_AdSoyad>
<Return_URL>r|https://dev.param.com.tr/tr</Return_URL>
<Islem_ID>202220</Islem_ID>
<Terminal_ID>10738</Terminal_ID>
<Taksit>1</Taksit>
</TO_Pre_Encrypting_OOS>
</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:Header>
<ServiceSecuritySoapHeader xmlns="https://turkodeme.com.tr/">
<CLIENT_CODE>10738</CLIENT_CODE>
<CLIENT_USERNAME>Test</CLIENT_USERNAME>
<CLIENT_PASSWORD>Test</CLIENT_PASSWORD>
</ServiceSecuritySoapHeader>
</soap:Header>
<soap:Body>
<TO_Pre_Encrypting_OOSResponse xmlns="https://turkodeme.com.tr/">
<TO_Pre_Encrypting_OOSResult>ImBuIu4mlRqIABImnjl/ikGHMe5ZOjZjP3wx61Wa7FxC3Xrjn
DTCsn7PngJ8DPdEV840PmqT+jVgsm+KaWcIZQq/lcJQKD3TdM99+MUcOKLxxFyByUJP3DkY9zZ4/2TJ7Px2HzZdf
ccockhMooHuM+A8PxjHKdK8z4pOvW/tpo/U4i6/jJPT9ZnhHL4GdRNOtu9l6sGtPHeKYC/FHYAZpGNXjR9+RCZGP
/xTeFgC+Gl1o7dpRZaibII6PdPK1CNMdF8O1d1QI+PDCq/TxDSQxyyJgqovzYfBHT5mWjOx+WhiajrswNzVirR9h
pii+Hq3sk+LnH90Psobh5db3F4BPpgUIuS6moVERKgq5HIhLkR4fe5TMfxcvOhj3Pg0RBQR
</TO_Pre_Encrypting_OOSResult>
</TO_Pre_Encrypting_OOSResponse>
</soap:Body>
</soap:Envelope>

To receive payment via iFrame, when you run the TP_Modal_Payment service, an iFrame link is returned in the response. You can navigate to the iFrame page using the related link.

After the payment transaction is completed, the transaction result is sent as a post request to the address specified in the Callback_URL parameter.

During test transactions, you can use our test cards.

Parameter Required Type Lenght Description
Code Yes Integer 5 The terminal ID will be provided by us.
User Yes String The User name will be provided by us.
Pass No String The Password will be provided by us.
GUID Yes String 36 Key belonging to the merchant.
GSM Yes String 10 Customer Phone number
Amount Yes String Amount
Order_ID Yes String 36 Order number
TransactionId No String 36 A unique ID is optional except for the Order ID related to the transaction.
Callback_URL Yes String 250 The page address where the transaction result will be posted if the payment transaction is successful/unsuccessful.
installment Yes Integer 2 The number of installments should be a value greater than 0 if you want to display all installments or just that specific installment number on the screen. 0: Shows all installments; greater than 0 shows that specific installment option.
MaxInstallment Yes Integer 2 It indicates the maximum number of installments to be displayed on the screen. For example, if 6 is entered, it shows installment options up to 6 installments. 0: Shows all installments; greater than 0 shows installment options up to that specific installment.
Parameter Type Lenght Description
ResultCode Integer If the result code returns a value greater than 0, the transaction is successful, and URL information is returned. In other cases, the transaction is unsuccessful.
ResultDescription String The result description returns an error message in cases where the transaction is unsuccessful.
URL String Returns the URL information that will open within the Iframe/Modal.
<?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_Modal_Payment xmlns="https://turkpos.com.tr/">
<d>
<Code>10738</Code>
<User>test</User>
<Pass>test</Pass>
<GUID>0C13D406-873B-403B-9C09-A5766840D98C</GUID>
<GSM></GSM>
<Amount>r|100,00</Amount>
<Order_ID>r|Iframe002221355</Order_ID>
<TransactionId>r|IframeTransaction0021255</TransactionId>
<Callback_URL>r|https://webhook.site/606c70fc-18c7-4adc-a523-ce4d7f732365</Callback_URL>
<MaxInstallment>r|12</MaxInstallment>
</d>
</TP_Modal_Payment> </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_Modal_PaymentResponse xmlns="https://turkpos.com.tr/">
<TP_Modal_PaymentResult>
<ResultCode>1</ResultCode>
<ResultDescription>Success</ResultDescription>
<URL>https://test-pos-mp.param.com.tr/Payment.aspx?token=Jj5cYWP+RX09ODuh8wrVSltngR7p5NSncBmWjxwifCaGXA5Yh7IAGY
LfhBhNbaqBz3+gGHOZcZq5ZSGeM9SX3qtpv/NpXVXS1xeRXyutBUi4/B0yx4oWiQwoE5VOMnqstRzZ0KS2tNTuJVnjPnK7mA5XhR+3Wa4fWWxZi9sm2Tvo
nJ/7p/kvaakJI94ePujcLvwM67AT595m1uAA4F1g4NsKmtRwVndXwdkeQIhj0vA0HS89sYIQigtvTuQIiQ6tc3YE4FWTFoPrU8e96NBaO6eGkBvYtSROcN
+E5Jco4ClPLN7zNT5A+XLLptMA+34JmiYBDpZP63kolmxhdivGfiCxK8MU1rznRGDXVPsciW8SzjjbN9A4v5K1SgtLFjoGdYyxj3olNVT3PftWj4iDmhIkm
xoEvjE5bN985SeUunEC5tYo2Hb6qg+935mohgVjZVz1gnh+MeYrBWcMwtaEnzvXnvrW3aa2NeF44ePIUVUIBMtcRCtymrHpHrEbs+u/0rLLf+FcpFQZx+wj
JWl0/g==</URL>
</TP_Modal_PaymentResult>
</TP_Modal_PaymentResponse>
</soap:Body>
</soap:Envelope>