Marketplace

With the Craftgate marketplace solution, merchants can create and update their sub-merchants on Craftgate, specify the money distribution to their sub-merchants during checkout, and allow sending money by giving approval. It is necessary for merchants to develop the marketplace API integration under three main headings.

  1. Creating and updating sub-merchants on Craftgate
  2. Distribution of money based on sub-merchants during payment
  3. Approval and withdrawal of items to send money to sub-merchants

Creating sub-merchants

In the Craftgate Marketplace solution, merchants must manage their sub-merchants’ money distribution at checkout. To do this, what must be done first is to create sub merchants in Craftgate. For member API integration, see: Create Member

Merchants can view the sub-merchants that they have created and updated with the API on the merchant panel and can perform detailed searches.

Payment integration

After the sub-merchants are created in Craftgate, the memberId parameter returns in the response of the API call and merchants must match this parameter with their own vendor. This parameter is used when distributing money to vendors during payment. For Payment API integration, see: Create Payment

In order to settlement to sub-merchants, two parameters are important during the payment.

price subMerchantMemberId subMerchantMemberPrice
Product Price Craftgate member id of the created sub-merchant The payout amount of the product which is added to the cart

For example, let’s say we have 3 products in our shopping cart and the sub-merchant of each product is different.

Product #1:

  • Product price: 30 TL
  • Sub-merchant member ID: 1
  • The amount to be settled to sub-merchant: 27 TL

Product #2:

  • Product price: 50 TL
  • Sub-merchant member ID: 2
  • The amount to be settled to sub-merchant: 42 TL

Product #3:

  • Product price: 20 TL
  • Sub-merchant member ID: 3
  • The amount to be settled to sub-merchant: 18 TL

As seen in the example, we have 3 items in our shopping cart, and we want to buy items from 3 different sub-merchants. Considering that the merchant works with different commissions with each seller, it should calculate the money distribution according to the commission received from the sub-merchant for each product in the shopping cart and specify the money to be sent during the payment. In the example above, the seller sells the first product in the basket for 30 TL, and the money that must be settled to the seller's account after the payment is 27 TL. Craftgate transfers money according to this parameter. The amount that will be settled to the sub-merchant and the merchant is determined by this parameter.

Item approval

For sending money in the marketplace solution, merchants are expected to approve each item in the basket when the escrow is completed. The settlement amount for the products that are not approved will not be transferred and will be kept in the pool account. Approval of approved items can be withdrawn if amount is not transferred. For API integration to approve the products, see: Item Approval