The RSM2000 Gateway: Paperless direct debit (PDD)

Reference name

A unique name for the gateway. It is a good idea for the name to include the type of gateway (eg. RSM PDD), the currency, and whether it is a live or test gateway.

Select gateway

Select the RSM PDD gateway

Vendor ID

Please note that this must be your RSM vendor ID for paperless direct debit. If you also have a vendor ID for card payments this will differ, so you will need to make sure you use the correct vendor ID for each. If you are setting up a test gateway, you can use the test vendor ID: 149

Currency

Select the appropriate currency for the gateway, subject to what you have agreed with RSM. (Currently only UK Direct Debits in GBP are possible with this gateway)

Test mode

Should be checked for a test gateway, must be unchecked for a gateway that will accept live donations.

Email Address

Mandatory

Alphanumeric

Email. Max 50 chars.

Title

Mandatory

Alpha

Title. Max 9 chars. Values accepted: Mr, Mrs, Mr & Mrs, Ms, Miss, Dr, Professor, Canon, Reverend, Sir, Lord, Lady, Other

First Name

Mandatory

Alpha

Forename. Max 50 chars.

Middle Name

Optional

Alpha

Middle name. Max 50 chars.

Last Name

Mandatory

Alpha

Surname. Max 50 chars.

Address 1

Mandatory

Alphanumeric

Address line 1 of account holder. Max 100 chars.

Address 2

Optional

Alphanumeric

Address line 2 of account holder. Max 100 chars.

Address 3

Optional

Alphanumeric

Address line 3 of account holder. Max 100 chars.

City

Optional

Alpha

Town/City of account holder address.

Region

Optional

Alpha

For UK this is the county. Max 30 chars.

Postcode

Mandatory

Alphanumeric

Post code of account holder address.

Country

Mandatory

Alpha

Country. Max 50 chars. (UK values accepted: UK, united kingdom, GBR) This field must be passed in on the page, but can be hidden from supporters. Set it as not visible when creating the form field.

Phone Number

Optional

Alphanumeric

Home phone number of account holder (accepts brackets, hyphens or spaces between numbers)

Payment type

Mandatory

Alpha

This field should be set to hidden with preset value: PDD

Credit Card Holder Name

Mandatory

Alpha

Exact name associated with the bank account. Max 50 chars.

Bank Account Number

Mandatory

Integer

Account number. 8 digits.

Bank Routing Transit Number

Mandatory

Integer

Sort Code. 6 digits, no spaces or dashes.

Donation Amount

Mandatory

Integer

May be entered as a whole number, or with two decimal places. Eg. Twelve pounds may be entered as ’12’ or ‘12.00’. You may want to consider using the ‘select with input’ or ‘radio with input’ field types, which will allow you to provide a few pre-defined values together with an option for the supporter to type in their own value. Enable the ‘Amount validator’ if you allow supporter input.

Recurring Payment

Mandatory

Alpha

In order for the gateway to recognise this is as a reoccurring payment, this field must send over the character ‘Y’. This field must be passed in on the page, but can be hidden from supporters. Set it as not visible when creating the form field.

Recurring Frequency

Mandatory

Integer (1,3,6,12)

Payment frequency: 1= monthly, 3= quarterly, 6= six monthly, 12= annually
It is possible to set up this form field in such a way that one value is displayed to supporters, while the valid numeric value is submitted to the gateway.

Recurring Start Date

Mandatory

Date format (dd/mm/yyyy)

Date of first collection.

Appeal Code

Optional

Alphanumeric

If you wish to tag your donations with a particular appeal code. Note: Only use alphanumeric names, as any special characters including – may be rejected by RSM.