We understand migrating your customers to a new payments platform is time consuming. Your customers have to ‘opt-in’ and sign new mandates.
To make the above process much easier for you and your customers, Zomentum Payments offers Bulk mandate migration functionality. Using this Zomentum will migrate the mandates from your existing payment provider to Zomentum Payments.
Supported Regions & Payment Methods
United States (US):
- Credit/Debit Cards
- ACH Direct Debit
United Kingdom (UK):
- Credit/Debit Cards
Here is how it works:
- Email support@zomentum.com for an encryption key
- Provide the encryption key to your existing payment provider and request them to encrypt the data w.r.t mandates in a csv file (format as per RFC 4180)
- Share the csv file with the Zomentum team at support@zomentum.com
Input file format
The files containing the data to be imported should be formatted as follows:
- Create a file in CSV (Comma Separated Values) format as per RFC 4180, in accordance with the following requirements:
- The first line contains the names of the fields. You do not have to use all field names and you do not have to use them in the same order as listed on this page.
- Each subsequent line contains the fields for a single recurring contract. In other words: Each recurring contract is on a separate line.
- If a field doesn't apply to the recurring contract that the line describes, specifying a value is skipped.
- Field names and values are case-sensitive.
- Multi-line fields are not allowed.
- The maximum file length is 1,000,000 lines.
- Save the file in UTF-8 format (to support non-western characters)
The following is an example input file with four recurring contracts:
MerchantAccount,ShopperEmail,ShopperReference,RecurringContract,EchoData,OwnerName,ExpiryMonth,ExpiryYear,ExpiryYYMM,ExpiryMMYY,ExpiryMMYYYY,ExpiryYYYYMM,CardNumber,Iban,CountryCode,BankLocation,BankName,BankLocationId,BankAccountNumber,BillingAgreementId,PayerId,BillingStreet,BillingCity,BillingState,BillingPostalCode,BillingCountry
TestMerchant,mark1test@adyen.com,mark1,RECURRING,MasterCard Bijenkorf NL,D.N. Mater,8,2018,,,,,5100081112223332,,,,,,,,,,,,,
TestMerchant,mark30test@adyen.com,mark30,"RECURRING,ONECLICK,PAYOUT",,P.Pal,,,,,,,,,,,,,,B-2308952346426,AK5HCWWRUV2KL,,,,,
TestMerchant,mark75test@adyen.com,mark78,RECURRING,,B.Dalby,,,,,,,,NO6012341234561,NO,,,,,,,,,,,
TestMerchant,mark2test@adyen.com,mark2,RECURRING,,B.Dalby,,,,,,,,,US,,,121000358,123456789,,,123 Test Street,San Francisco,CA,94000,US
Input file fields
The fields for recurring contracts are:
Field | Required | Description |
ShopperReference | Yes | An ID that refers uniquely to the shopper. For example, a customer ID in a shopping cart system. Minimum length: three characters. |
Apart from the above fields, the CSV file can have fields for:
- Card Data
- ACH
Card fields
When specifying card data, you need to provide:
- Card number.
- Expiry date: month and year of expiry. You can use either a combination of fields (ExpiryMonth and ExpiryYear), or a single field to specify both month and year: ExpiryMMYY, ExpiryMMYYYY, ExpiryYYMM or ExpiryYYYYMM.
Data | Required | Description |
CardNumber | Yes | The card number. |
Expiry date | Yes | Either a single field or a combination of fields is required. Choose from the following fields.
|
networkTxReference (for Visa | Yes | The Visa Transaction ID from the initial transaction where the shopper signed up for a series of Subscription or UnscheduledCardOnFile payments. |
ACH fields
Field | Required | Description |
BankLocationId | Yes | The ABA routing transit number of the account. |
BankAccountNumber | Yes | The US bank account number from which the payment will be debited. |
OwnerName | Yes | Name on the bank account. |
CountryCode | Yes | US |
BillingHouseNumberOrName | Yes | The number or name of the house. You can omit this and include the data in BillingStreet. |
BillingStreet | Yes | The street name. |
BillingCity | Yes | The city name. |
BillingStateOrProvince | Yes | A valid 2-character abbreviation for the state |
BillingPostalCode | Yes | The postal code. |
BillingCountry | Yes | US |