Server-Side Implementation
Availability
Masterpass has been replaced with the latest unified checkout experience offered through Visa
known as Secure Remote Commerce (SRC). If you were previously using Masterpass, you will need to
integrate with SRC. SRC is currently in
a limited release to
eligible merchants, and the API is subject to change. It was introduced in Android v2, iOS v4, and JavaScript v3 of
our Client SDKs.Contact us to request access to the release.
Creating transactions
Creating a Masterpass transaction is the same as creating any other transaction with a nonce.Collect device data
from the client and include the device_data_from_the_client in the
transaction.
- Ruby
result = gateway.transaction.sale(
:amount => "10.00",
:payment_method_nonce => nonce_from_the_client,
:device_data => device_data_from_the_client,
:options => {
:submit_for_settlement => true
}
)
if result.success?
# See result.transaction for details
else
# Handle errors
endVaulting Masterpass
Important
Vaulting can only be used to support recurring transactions. You will need to obtain approval from
Masterpass in order to do so.
- Ruby
result = gateway.payment_method.create(
:customer_id => "131866",
:payment_method_nonce => nonce_from_the_client
)Transaction: Sale with
options.store_in_vault
or
options.store_in_vault_on_success. You can create a recurring transaction by using
Transaction: Sale
with
recurring. It is important to note that Masterpass does not support split shipments or one-off transactions
with vaulted payment information. If you attempt to create a non-recurring transaction from a
vaulted Masterpass card, you'll receive a
validation error:
"Vaulted cards from this payment method can only be used for recurring transactions."