Extra merchant data
This document describes the additional customer, merchant, and purchase information (extra merchant data, or EMD) that Kustom Checkout may require.
Extra merchant data is typically not available at checkout but is used for better risk assessment, enabling new promotional products, and improving conversion rates.
Sharing EMD is optional for some scenarios but mandatory in specific segments and use cases.
Mandatory EMD for Specific Segments/Use Cases
The following table outlines segments and use cases requiring specific EMD:
| Segment and other use cases | EMD required | Details |
|---|---|---|
| Travel | air_reservation_details, train_reservation_details, bus_reservation_details, ferry_reservation_details, car_rental_reservation_details, hotel_reservation_details, trip_reservation_details | Required if selling travel services, including passenger and itinerary details. |
| Marketplace | marketplace_seller_info | Required for marketplace services, providing details about the sub-seller. |
| Ticketing | event | Required when selling event tickets, providing event information. |
| Subscriptions and On-Demand | customer_tokens | Required for subscriptions or recurring payments, needing specific subscription object and customer information. |
| Selling in physical store | in_store_payment | Required for any segment if the purchase is done in-store to evaluate transaction risks and purchase location. |
| Registered checkout | customer_account_info, payment_history_full, payment_history_simple | Required for registered users for identifying returning customers and enhancing services. |
| Pick up in store | other_delivery_address | Required when selling products for pick-up in-store to evaluate transaction risks. |
In addition, specific EMD may be requested during merchant onboarding based on risk assessment. Refer to the attachments specification for detailed data fields.
How to Send EMD
Provide the required data under the attachment property of the order. Contact your Kustom Checkout account manager or KCO merchant support to determine the correct product vertical for your needs. You should add the EMD to the order using the Create order or Update order API call.
An example of sending extra merchant data for recurring orders is shown below:
JSON example
{
//...
"attachment": {
"content_type": "application/vnd.klarna.internal.emd-v2+json",
"body": "{ \"subscription\": [{ \"subscription_name\": \"Contact_lenses\", \"start_time\": \"2020-11-24T15:00\", \"end_time\": \"2021-11-24T15:00\", \"auto_renewal_of_subscription\": false }], \"customer_account_info\": [{ \"unique_account_identifier\": \"Adam_Adamsson\", \"account_registration_date\": \"2020-11-24T15:00\", \"account_last_modified\": \"2020-11-24T15:00\"}] }"
}
}