- Merchant-related losses over the last 5 years
- One row per loss event
- Improves pricing accuracy and coverage limits
Merchant identity
These fields must match the corresponding values in your merchant list.string
required
The legal registration ID of the merchant, matching your merchant list.Example:
"201912345H" (SG) or "5457657" (US)string
required
The type of registration ID based on the country where the merchant is registered.Example:
"UEN" (SG) or "SOS" (US)string
required
The country where the merchant is legally registered, as a two-letter code per ISO 3166 alpha-2.Example:
"SG"string
The state where the merchant headquarters are legally registered, per ISO 3166-2:US. Mandatory for US merchants, can be left blank for non-US merchants.Example:
"US-NY"string
required
The merchant’s legal name as registered with the relevant government authority.Example:
"ABC Trading Ltd."string
The first line of the merchant’s legally registered address.Mandatory for US merchants, can be left blank for non-US merchants.Example:
"100 High Street"string
The second line of the merchant’s legally registered address.Mandatory for US merchants, can be left blank for non-US merchants.Example:
"Suite 300"string
The city in which the merchant is legally registered.Mandatory for US merchants, can be left blank for non-US merchants.Example:
"London"string
The postal code or ZIP code of the merchant’s legally registered address.Mandatory for US merchants, can be left blank for non-US merchants.Example:
"238884"string
required
A comma-separated list of Merchant Category Codes (MCC).Example:
"5251, 5714"string
required
The currency in which figures are reported, as a three-letter code per ISO 4217.Example:
"SGD"Loss details
date
required
The date when losses started to occur from this merchant, formatted as ISO 8601.Example:
"2024-01-30"integer
required
The total value of losses suffered from this merchant. Whole number, no decimals.Example:
8000000integer
The last 12 months of TPV processed by this merchant prior to the loss occurring. Whole number, no decimals.Example:
8000000integer
The total value of collateral held for risk prevention purposes at the time of the loss. Whole number, no decimals.Example:
8000000string
required
A description of the loss and any details relevant to the insurance coverage.Example:
"Merchant ceased trading without fulfilling customer orders. No assets recovered."