Marketplace

What is Marketplace?

Marketplace is a virtual mall that brings together several stores or service providers, that is, in a single place the customer can buy several products or services from partner stores to the marketplace and make a single payment. It is a form of sales widely used by stores or service providers who are starting their business and wish to serve a greater number of customers in a structured way without having to invest in a physical store or marketing, for example. On the other hand, it is widely used by marketplaces that want to diversify the offer of their products, have their brand increasingly known, in addition to offering a simplified process to more and more stores or service providers on their platform, without the restriction of branches. of activities.

Why working with Marketplace is good?

  • GOOD for Consumers who find everything in one place!
  • GOOD for Merchant/Provider who can sell on multiple marketplaces and grow their business.
  • GOOD for the Marketplace that has revenue from the concentration and rate of sales, in addition to increasing the average purchase ticket.

Payment split

When the customer completes his purchases and clicks on payment, behind this single payment there is the Payment Split, that is, the Payment Split is the possibility of split a single payment between each store or service provider involved in the sale. This payment will be made via the Adiq e-commerce gateway and, at the time of settlement, Adiq splits the payment according to the rules registered by the Marketplace.

Here is an example:

Split payments

Rules for splitting the payment may contain:

  • Settlement triggers: Marketplace needs to authorize payment to the store or service provider as it depends on some confirmation, such as stock, delivery, etc.
  • Flexible settlement period: Marketplace can define that payment to the store or service provider can take place on D+10 and to another store or service provider it can happen on D+15.

Unlock payment

Unlock payment

To unlock a payment made via Marketplace, it is necessary to send a request using the POST method to the resource, as shown in the example. This operation is Marketplace specific.

Request

                
                
{
    "sellerId": "901",
    "amount": 690,
    "date": "2019-11-13T13:48:18.4361271+00:00",
    "item": {
    "id": "P115DU90",
    "amount": 690
    }
}
                            
                        
                    
Property Description Type Location Required
PaymentId Payment identifier to be consulted. string path yes
SellerId Identifier of the establishment. string body yes
Amount Total unlock value (in cents). integer body yes
Date Payment unlock date. datetime body yes
Item.Id Item identifier. string body yes
Item.Amount Item value (in cents). integer body yes

Response

                
                
Success
Status code 200

Bad Request
Status code 400
[
    {
        "tag": "PaymentId",
        "description": "Não pode ser nulo ou vazio."
    }
]
                        
                        
                    

Payment unlock update

To update the unlock date of a payment made via Marketplace, it is necessary to send a request using the PUT method to the resource as shown in the example.

Request

                
                
        {
            "sellerId": "901",
            "amount": 690,
            "date": "2019-11-13T13:48:18.5180698+00:00",
            "previousDate": "2019-11-13T13:48:18.5180765+00:00",
            "item": {
            "id": "P115DU90",
            "amount": 345
            }
        }
                                    
                                
                            
Property Description Type Location Required
PaymentId Payment identifier to be consulted. string path yes
SellerId Identifier of the establishment. string body yes
Amount Total unlock value (in cents). integer body yes
Date Payment unlock date. datetime body yes
PreviousDate Date previously informed. datetime body yes
Item.Id Item identifier. string body yes
Item.Amount Item value (in cents). integer body yes

Response

                
                
Success
Status code 200

Bad Request
Status code 400
[
    {
        "tag": "PaymentId",
        "description": "Não pode ser nulo ou vazio."
    }
]