Marketplace

Marketplace project with multiple buyers will be able to shop from the merchant group, then make payments for the relevant products and payments can be easily transferred to vendor groups.

Within the scope of the Marketplace project; member is an integration API help document prepared for the services that businesses will use.

CONNECTION ADDRESSES

PROD ENVIRONMENT
* In our prod environment, security control is performed on access to web service methods using the ST_WS_Guvenlik object. Therefore, you need to register your server's static outbound IP Address (if multiple IP Addresses exist, IP Address Blocks) in the Param panel under the ParamPOS > My Integration Information section. If the registration is not completed, an error is expected.

It will also be forwarded.

TEST ENVIRONMENT
* In our test environment, security control is performed on access to web service methods using the ST_WS_Guvenlik object. Therefore, you need to send your server's static outbound IP Address (if multiple IP Addresses exist, IP Address Blocks) to the email address [email protected] for registration. If the registration is not completed, an error is expected.

https://testposws.param.com.tr/turkpos.ws/service_pazaryeri.asmx?wsdl?wsdl

Not: Card storage, Card storage List, Delete Stored Card and Payment methods https://dev.param.com.tr/en/api from the link can be reached.

PROCESS FLOWS

4.1 Marketplace Sub-Member Merchant Operations

• Pazaryeri_TP_AltUyeIsyeri_Ekleme method is used to define information related to a member business. On the Param side, there must be a Pos account starting with 6371 for the Marketplace. The same member business is defined only once.
• Pazaryeri_TP_AltUyeIsyeri_Guncelleme method can be used to update the information of the added sub-member business.
• Pazaryeri_TP_AltUyeIsyeri_Liste method can be used to query the sub-member business at all stages.

4.2 Order Payment and Order and Payment Cancellation/Refund transactions

• By running the SHA2B64 method located at https://dev.param.com.tr/en/api/sha2b64, the Islem_Hash value is generated.
• Using the value of the Islem_Hash parameter, the payment process is initiated with any of the methods: Sale-3D Pay / NS / Sale-3D Model / NS / Payment with MasterPass / Payment with Foreign Currency / Payment with Card Storage / Payment with BKM Express. The Order Amount is transferred to the Marketplace account.
• Upon successful payment, the Pazaryeri_TP_Siparis_Detay_Ekle method is run; previously saved sub-member business, Islem_ID returned from the Payment methods, and net amount after commission deduction are sent.
• If transactions are not to be canceled or refunded, the Pazaryeri_TP_Siparis_Onay method is run; the order is approved, and on the due date, the relevant amount is transferred to the IBAN of the sub-member business.
• If transactions are to be canceled or refunded, the Pazaryeri_TP_Iptal_Iade method is run after the Pazaryeri_TP_Siparis_Detay_Ekle or Pazaryeri_TP_Siparis_Onay operations. The amount is refunded to the user's card who made the payment.
• The Pazaryeri_TP_Islem_Sorgulama method can be run at every step.

METHODS

Unless specified otherwise, all parameters sent to the methods are mandatory fields. Security checks are performed in Web Service methods with the ST_WS_Guvenlik object. To pass the ST_WS_Guvenlik object with the following information, please also send us your server IP Address (if multiple IP Addresses, IP Address Blocks) or your website address.

ST_WS_Guvenlik object:

The following information will be communicated once the integration process is successfully completed. Until this stage, you can use the test information in item 3.

TECHNICAL SUPPORT TOPICS

For technical issues you encounter regarding integration, you can send all your support requests to [email protected].