MOTO (Mail Order Telephone Order)

This guide provides a comprehensive guide on executing MOTO transactions utilizing Bridgerpay's platform.

Suggest Edits

A Mail Order/Telephone Order (MOTO) transaction refers to a card-not-present transaction in which the customer shares their order and payment details through traditional mail (not email), fax, or telephone. By providing you with this information, the cardholder explicitly authorizes you to initiate the transaction processing.

🚧

Kindly ensure that you enable the "MOTO" option for the selected Payment Service Provider (PSP) where you intend to process MOTO transactions. Additionally, if the payment provider requires the CVV (Card Verification Value), please activate the "MOTO Requires CVV" option as well. These settings will allow for seamless processing of MOTO transactions with the necessary CVV information, as requested by the payment provider.

📘

When initiating a MOTO transaction, please note that only the Payment Service Providers (PSPs) for which the "MOTO" toggle is enabled will process the transaction. Any other PSPs on the same route that do not have the "MOTO" toggle enabled will be skipped and not involved in the transaction processing. This ensures that MOTO transactions are exclusively handled by the designated PSPs with the necessary capabilities and settings.

There are two distinct methods for conducting MOTO transactions:

  1. Utilizing the Checkout Widget.
  2. Employing a server-to-server API integration.

Feel free to explore our Postman collection:

Checkout Widget

In this scenario, the Checkout Widget will be integrated into the merchant's internal system, enabling employees to initiate transactions on behalf of the payer.

Follow the subsequent steps to successfully generate a checkout widget:

  1. Get authorized as a merchant.
  2. Create a MOTO server session request to generate a cashier token.
POST https://api.bridgerpay.com/v2/cashier/session/create/{api_key}
Content-Type: application/json
Authorization: Bearer {{ACCESS_TOKEN}}
{
  "cashier_key": "{cashier_key}",
  "order_id": "g173aa02",
  "mid_type": "moto",
  "currency": "EUR",
  "country": "NL",
  "first_name": "Juan",
  "last_name": "Lopez",
  "email": "[email protected]",
  "language": "en",
  "state": null,
  "address": "Boenluif 30",
  "city": "Hoogwoud",
  "zip_code": "1718 AZ",
  "amount": 10,
  "phone": "+328141112233"
}

The present request adheres to the standard server session, but it incorporates an additional parameter known as "mid_type" that facilitates the execution of MOTO (Mail Order/Telephone Order) transactions.

  1. Embed a Checkout by using cashier_key and the generated cashier_token.

To display the Checkout widget in an HTML-supporting application, such as a web browser, you can integrate the server-side checkout scheme by inserting the following code as a script or embedding it within an iframe on a desired web resource:

<!DOCTYPE html> 
<html> 
<body> 
<script src="https://checkout.bridgerpay.com/v2/loader" 

data-cashier-key="{cashier_key}" 
data-cashier-token="{cashier_token}" 

> 
</script> 
</body> 
</html>

<!DOCTYPE html>
<html>
<body>
<iframe width=700px height=1000px src="https://checkout.bridgerpay.com/v2/?

cashierKey={cashier_key}&
cashierToken={cashier_token}"

>
</body>
</html>

Server-to-server

  1. Get authorized as a merchant.
  2. Create a MOTO request.
POST https://api.bridgerpay.com/mpi/v2/{api_key}/deposit/credit-card
Content-Type: application/json
Authorization: Bearer {{ACCESS_TOKEN}}
Accept-Language: en
{
  "cashier_key": "{cashier_key}",
  "order_id": "g173aa11", 
  "mid_type": "moto",
  "save_card": true,
  "first_name": "John",
  "last_name": "Smith",
  "email": "[email protected]",
  "currency": "EUR",
  "country": "BE",
  "state": null,
  "address1": "Rue du Pont Simon 115",
  "city": "Appelterre-eichem",
  "zip_code": "9900",
  "amount": 10,
  "phone": "+328141112233",
  "card_holder_name": "John Smith",
  "credit_card_number": "4012888888881881",
  "expire_month": 01,
  "expire_year": 2023,
  "cvv2": "111"
}

Using Server to Server with credit card token

POST https://api.bridgerpay.com/mpi/v2/{api_key}/deposit/credit-card
Content-Type: application/json
Authorization: Bearer {{ACCESS_TOKEN}}
Accept-Language: en
{
  "cashier_key": "{cashier_key}",
  "order_id": "g173aa11", 
  "mid_type": "moto",
  "save_card": false,
  "first_name": "John",
  "last_name": "Smith",
  "email": "[email protected]",
  "currency": "EUR",
  "country": "BE",
  "state": null,
  "address1": "Rue du Pont Simon 115",
  "city": "Appelterre-eichem",
  "zip_code": "9900",
  "amount": 10,
  "phone": "+328141112233",
  "credit_card_token":"{credit_card_token}",
  "cvv2": "111"
}

Updated 3 months ago