Additional underwriting data

A new field additional_underwriting_data object will be added to the create merchant endpoint for the platform to send merchant specific information to Rainforest when initiating the merchant onboarding process.

This field will not be returned in the Rainforest API on merchant or merchant application endpoints.

Field	Type	Description
`merchant.start_date`	String, in the format of `YYYY-MM-DD`	The merchant start date on the platform.
`historic_payment_volume.last_30_days`	Integer, $ amount in cents	The total payment volume processed in the last 30 days (1 month).
`historic_payment_volume.last_180_days`	Integer, $ amount in cents	The total payment volume processed in the last 180 days (6 months).
`historic_payment_volume.currency_code`	String, enum of `USD`	Three-letter ISO currency code, in uppercase. Currently, only USD is supported.
`subscription.amount`	Integer, $ amount in cents	The merchant's subscription cost to the platform, dependent on the frequency.
`subscription.currency_code`	String, enum of `USD`	Three-letter ISO currency code, in uppercase. Currently, only USD is supported.
`subscription.frequency`	String, enum list of `ONE_TIME`, `WEEKLY`, `MONTHLY`, `ANNUALLY`, `OTHER`	The frequency the merchant's subscription amount is paid to the platform.

Example Payload

{
  // ...
  "additional_underwriting_data": {
    "merchant": {
      "start_date": "2023-12-01",
    },
    "historic_payment_volume": {
      "last_30_days": 100000, // $1,000.00
      "last_180_days": 600000, // $6,000.00
      "currency_code": "USD"
    },
    "subscription": {
      "amount": 10000, // $100.00
      "currency_code": "USD",
      "frequency": "MONTHLY"
    }
  }
}