Envisso Protect Pricing Hub
5 min
this pricing requirements overview will give you the context for providing data to envisso for the purposes of protect insurance pricing getting indicative protect insurance pricing & limits requires 2 primary datasets merchants list of merchants and the details associated to them losses details of any merchant related losses incurred over the last 5 years merchants file context the merchant file should contain all active merchants within your platform that would be covered under the envisso protect insurance policy file type csv or excel delivery email (to your primary contact) or sftp (on request) template file the following table provides the column definitions for the merchant data each row in this file represents a merchant as a legal entity, as it is registered with the relevant government authority, rather than individual merchant accounts as defined by payment service providers (psp) column name description merchant registration id (string) (string) mandatory the legal registration id of the merchant this id is assigned by the relevant government authority in the merchant's registered country refer to the data dictionary for specific formats and examples per country depending on the registration id type and the registered country, the record may be rejected due to this merchant registration id being in an invalid format and will have to be re sent in a subsequent file example for a singaporean merchant "201912345h" registration id type (enum) (enum) mandatory the type of registration id based on the country where the merchant is registered refer to the “registration id type” data dictionary for the complete list of registration id types per country if the value given is not a valid registration id type as per envisso data dictionary for the country specified in registered country , the record will be rejected and will have to be re sent in a subsequent file example for a singaporean merchant "uen" registered country (country) (country) mandatory the country where the merchant is legally registered, represented as a two letter country code according to the https //en wikipedia org/wiki/iso 3166 standard in its alpha 2 format example for a singaporean merchant "sg" merchant legal name (string) (string) mandatory the merchant's legal name as it is registered with the relevant government authority example "abc trading ltd " mccs (string) (string) mandatory a space separated list of merchant category codes (mcc) an mcc is formatted as a 4 digits string based on iso 18245 example "5251 5714" company registration date (date) (date) mandatory the official registration date of the merchant’s company, formatted as an https //en wikipedia org/wiki/iso 8601 date example "2024 01 30" onboarding date (date) (date) mandatory the onboarding date of the merchant in the psp system, formatted as an https //en wikipedia org/wiki/iso 8601 date example "2024 01 30" last 12 months tpv (integer) (integer) mandatory the last 12 months total payment volume (tpv) processed by this merchant this should be provided in the main unit of the currency defined in trading currency , without thousand delimiters and without any decimal places example 8000000 last 12 mths transaction count (integer) (integer) mandatory the number of transactions this merchant processed in the last 12 months example 10000 trading currency (string) (string) mandatory the currency in which the merchant is trading, represented as a three letter currency code according to the https //en wikipedia org/wiki/iso 4217 standard in its alpha 3 format generally this will be the currency in which the merchant will be paid example "sgd" value at risk (integer) (integer) mandatory the maximum loss the psp could suffer if the merchant defaults, assuming there is no collateral this should be provided in the main unit of the currency defined in trading currency , without thousand delimiters and without any decimal places example 135000 delivery days (integer) (integer) mandatory the average number of days between when the merchant receives payment and when they deliver goods or services to their customers this should be provided as a whole number representing calendar days, with 0 indicating immediate delivery (e g , digital goods) and larger numbers indicating longer delivery timeframes example 14 collateral held (integer) (integer) mandatory the total value of collateral held for risk prevention purposes for the merchant t his should be provided in the main unit of the currency defined in trading currency , without thousand delimiters and without any decimal places example 8000000 desired insurance limit ( ( integer integer ) ) optional desired insurance limit,i f you have one, null if you're happy for envisso to propose one t his should be provided in the main unit of the currency defined in trading currency , without thousand delimiters and without any decimal places example 8000000 website url (url) (url) optional the merchant's website url the protocol (http // or https //) can be omitted for example it is possible to use "www example com" instead of "https //www example com" example "www timstiles com" registered address line 1 (string) (string) optional the first line of the merchant's legally registered address this typically includes the street address or po box number example "100 high street" registered address line 2 (string) (string) optional the second line of the merchant's legally registered address this can include additional address details such as suite or apartment number example "suite 300" registered city (string) (string) optional the city in which the merchant is legally registered example for a merchant based in london "london" registered postal code (string) (string) optional the postal code or zip code of the merchant's legally registered address example "238884" losses file context this file provides details of merchant related losses over the past 5 years file type csv or excel delivery email (to your primary contact) or sftp (on request) template file the following table provides the column definitions for the losses data each row in this file represents a loss assocaited with a merchant in the last 5 years column name description merchant registration id (string) (string) mandatory the legal registration id of the merchant this id is assigned by the relevant government authority in the merchant's registered country refer to the data dictionary for specific formats and examples per country depending on the registration id type and the registered country, the record may be rejected due to this merchant registration id being in an invalid format and will have to be re sent in a subsequent file example for a singaporean merchant "201912345h" registration id type (enum) (enum) mandatory the type of registration id based on the country where the merchant is registered refer to the “registration id type” data dictionary for the complete list of registration id types per country if the value given is not a valid registration id type as per envisso data dictionary for the country specified in registered country , the record will be rejected and will have to be re sent in a subsequent file example for a singaporean merchant "uen" registered country (country) (country) mandatory the country where the merchant is legally registered, represented as a two letter country code according to the https //en wikipedia org/wiki/iso 3166 standard in its alpha 2 format example for a singaporean merchant "sg" merchant legal name (string) (string) mandatory the merchant's legal name as it is registered with the relevant government authority example "abc trading ltd " mccs (string) (string) mandatory a space separated list of merchant category codes (mcc) an mcc is formatted as a 4 digits string based on iso 18245 example "5251 5714" trading currency (string) (string) mandatory the currency in which the merchant is trading, represented as a three letter currency code according to the https //en wikipedia org/wiki/iso 4217 standard in its alpha 3 format generally this will be the currency in which the merchant will be paid example "sgd" loss start date (string) (string) mandatory the date when the losses started to occur from this merchant, formatted as an https //en wikipedia org/wiki/iso 8601 date example "2024 01 30" total loss amount (integer) (integer) mandatory the total value of the losses suffered from this merchant this should be provided in the main unit of the currency defined in trading currency , without thousand delimiters and without any decimal places example 8000000 prior 12 months tpv (integer) (integer) mandatory the last 12 months of total payment volume (tpv) processed by this merchant prior to the loss occuring this should be provided in the main unit of the currency defined in trading currency , without thousand delimiters and without any decimal places example 8000000 collateral held at time of loss (integer) (integer) mandatory the total value of collateral held for risk prevention purposes for the merchant at the time of the loss occuring t his should be provided in the main unit of the currency defined in trading currency , without thousand delimiters and without any decimal places example 8000000 loss description ( ( string string ) ) mandatory a description of the loss and any details that are relevant to the insurance coverage
