Bulk offers
This specification describes data structure for the handover of generated bulk offers for a set of eligible merchants.
Note
You need to accept data according to this specification from Flowpay in order to facilitate either Linkout flow or customer base pre-scoring option of Fully Embedded (Native) or Embedded (iFrame) flow.
Scope
Handover of bulk offers generated by Flowpay based on provided merchant sales transaction data for a set of eligible merchants.
Data specification
- Data format: bulk file in CSV format with UTF-8 encoding
- File name:
{YYYYMMDD}_{YOUR_PARTNER_CODE}_offers.csv
| Attribute | Description |
|---|---|
merchantId |
mandatory, identifier of the merchant as provided by partner in the Bulk sales transactions data file |
flowpayOfferId |
mandatory, unique offer identifier (UUID) |
flowpayOfferUrl |
mandatory, URL of the landing page of Flowpay’s customer origination app where the customer should be navigated to if interrested in the financing |
M1_EUR_amount |
optional, offered amount for M1 product in EUR |
M1_EUR_rate |
optional, offered rate for M1 product in EUR |
M3_EUR_amount |
optional, offered amount for M3 product in EUR |
M3_EUR_rate |
optional, offered rate for M3 product in EUR |
M6_EUR_amount |
optional, offered amount for M6 product in EUR |
M6_EUR_rate |
optional, offered rate for M6 product in EUR |
M12_EUR_amount |
optional, offered amount for M12 product in EUR |
M12_EUR_rate |
optional, offered rate for M12 product in EUR |
Data distribution
- Transport protocol: either download from Azure Blob Storage managed by Flowpay or providing Flowpay access to upload the data to a storage managed by partner (e.g, AWS S3, Azure Blob Storage, Google Cloud Storage, etc)
- Periodicity: monthly