Search
K

Uploading Data for Indicative Offers

Wayflyer’s Embedded Capital API enables partners to generate indicative offers for their customers by sharing anonymised customer data, helping them access financing faster and more efficiently..

This guide explains why and how to share data, the required frequency for uploads, and the expected data schema.

Why share data?

Sharing anonymized customer data with Wayflyer is a simple way to create a more powerful and seamless experience for your users.

  • Unlock indicative offers: Wayflyer will use the anonymized customer data to screen for financing eligibility in real-time. If eligible, your users will be presented with a tailored indicative offer in the embedded call-to-action(CTA) component.
  • Enhance the user experience: Sharing this data with Wayflyer ensures your users are only shown offers and calls-to-action that are relevant to their business. This reduces noise and creates a more seamless user experience.

How to Share Data

Partners can share data for indicative offers with Wayflyer in two ways:

  1. Batch Upload: (Recommended)
  • Best for small-to-medium datasets or regular updates.
  • Send a JSON array of company data in a single API request.
  • See API endpoint guide here
  1. File Upload:
  • For large datasets, split your data file into parts and upload each part separately.
  • After all parts are uploaded, call the complete file upload endpoint to trigger processing.
  • See API endpoint guide here

How Often Should You Share Data?

  • Recommended Cadence: Weekly
  • More regular data sharing is welcome, and can improve offer accuracy.
  • For businesses with a fast-growing customer base or significant revenue shifts, more frequent data sharing helps keep indicative offers up-to-date and highly relevant.

Expected Data Schema

Ideally, each company should be represented as an object with these fields. There are 3 options for revenue reporting and it is required to provide at least 1 of them and they will be used with the following priority:

  1. Annual revenue (Recommended).
  • If the information of the full year (12 months) revenue is available, you should provide it through the annual_revenue key.
  1. Revenue in period.
  • If you don't have the information of the revenue for a full year, but you know the revenue for a number of months, you should provide it through the revenue_in_period key.
  • You should also provide the number of months that the revenue covers through the num_period_months key.
  1. Shipping in period.
  • Finally, if you don't have any revenue information about this company, but you know the shipping cost for a number of months (1-12), then you could provide them through the shipping_in_period key. We will then apply a formula that assumes the revenue from the shipping cost.
  • You should also provide the number of months that the shipping cost covers through the num_period_months key.

If you don't have all the data, please contact your Partnerships Manager. We can work with you to adapt the process.

[
  {
    "company_id": "abc123",
    "annual_revenue": 1000000,
    "shipping_in_period": 10000,
    "num_period_months": 6,
    "currency": "USD", // ISO 4217 currency code
    "country": "US", // ISO 3166-1 alpha-2 code
    "state": "US-CA", // ISO 3166-2 code
    "incorporation_date": "2025-06-23",
    "client_onboarding_date": "2025-06-23"
  }
]

Example: Batch Upload Request

curl -X POST 'https://api.wayflyer.com/v1/partner/anon-data-upload/batch/' \
  -H 'accept: application/json' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer <your_partner_token>' \
  -d '[
    {
      "company_id": "merchant01",
      "annual_revenue": 1400000,
      "currency": "GBP",
      "country": "GB",
      "incorporation_date": "2020-01-01",
      "client_onboarding_date": "2020-01-01"
    },
    {
      "company_id": "id2",
      ...
    }
  ]'

Contact Wayflyer support if you have any questions.