The Marketplace solution presupposes the availability of APIs which, in turn, make it possible to carry out a variety of operations. The following subsections detail each of these.
In addition, information on these APIs is available through the following link SIBS API Market .
Marketplace parameters
Add/Change Marketplace parameters
Allows the Marketplace Operator to define or change who will be assigned to the responsibility of validating Submerchants. This process, required by payment industry regulations, can be performed by the Acquirer(s) of the solution or can be delegated to the Marketplace Operator.
When the validation of Submerchants is defined as being the Acquirer(s) responsibility, the User must further define whether or not he/she wants the Submerchant status “Pending” to be allowed. If you opt for delegated validation at the Marketplace Operator, Acquirers do not have to perform KYC validation and Submerchants move directly to the “Active” status.
In this feature, the Marketplace Operator must also define the IBAN and BIC of the bank account where they wish to receive their Marketplace fees.
Access via SIBS API Market:
PUT /sibs/v1/marketplaceoperator
This action implies the updating of all the information sent in the interface of this feature. In this sense, it is recommended to use the “Inquire Submerchant” feature beforehand, to avoid deleting relevant information.
This feature requires sending parameters at the Request level that have the following characteristics:
Table 2 – Paramenters of the “Add/Change Marketplace Parameters” feature
| Parameter | Meaning | Accepted values and their meaning | Format | Minimum lenght | Maximum lenght | Type |
|---|---|---|---|---|---|---|
| “marketplaceOperator” | ||||||
| “validationTypeCode” | Submerchant Code | “AAV” (Default) – All Acquirers Validation – Validation by all Acquirers “NSV” – No Submerchant Validation – No Validation | Decimal | 8 | 8 | Mandatory |
| “submerchantPending AcceptanceIndicator” | “Pending” status permission | “1” = Yes “0” = No | Boolean | 1 | 1 | Mandatory |
| “settlementTypeCode” | Clearing type | “SPA” – Single Euro Payments Area | String | 3 | 3 | Mandatory |
| “financial” | ||||||
| “escrowAccount” | IBAN International Bank Account Number | – | String | 1 | 34 | Mandatory |
| “escrowAccount” | BIC Bank International Code | – | String | 11 | 11 | Mandatory |
| “liableAccount” | IBAN International Bank Account Number | – | String | 1 | 34 | Mandatory |
| “liableAccount” | BIC Bank International Code | – | String | 11 | 11 | Mandatory |
Inquire Marketplace Parameters
Allows to inquire all the characteristics defined in the “Add Marketplace Parameters” feature.
Access via SIBS API Market:
GET /sibs/v1/marketplaceoperator