Skip to content
APIs
/
Payments
/
Additional Features
/
MOTO (Mail Order/Telephone Order)

MOTO (Mail Order/Telephone Order) payments

This feature enables you place Mail Order/Telephone orders on behalf of your customers.

MOTO transactions are only available for Customer Initiated Transactions (CITs) using cards. 3DS authentication is not applicable and will return an error if the threeDS object is included.

How to enable

Using the top level channel key and setting the value to moto enables a Mail Order/Telephone Order payment. See our API reference.

Channel key

{
....
"channel": "moto",
....
}

Full example:

application/json

A one-off MOTO card payment using a plain card number

{
  "transactionReference": "Memory265-13/08/1876",
  "merchant": {
    "entity": "default"
  },
  "channel": "moto",
  "instruction": {
    "method": "card",
    "paymentInstrument": {
      "type": "plain",
      "cardHolderName": "Sherlock Holmes",
      "cardNumber": "4000000000001091",
      "expiryDate": {
        "month": 5,
        "year": 2035
      },
      "billingAddress": {
        "address1": "221B Baker Street",
        "address2": "Marylebone",
        "address3": "Westminster",
        "postalCode": "SW1 1AA",
        "city": "London",
        "state": "Greater London",
        "countryCode": "GB"
      },
      "cvc": "123"
    },
    "narrative": {
      "line1": "trading name"
    },
    "value": {
      "currency": "GBP",
      "amount": 42
    }
  }
}

Outcome details

The payment response does not include any channel specific information.