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:
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. read>
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."
}
]