Express callbacks

API documentation for version 2 and version 3 of the Spreedly Express Javascript API.

🚧

Non-secure tokenization through Express will be deprecated on October 31, 2026, with end of life on December 31, 2028. See the Express payment form guide for what's changing and how to stay supported.

Callbacks

Express supports a variety of callbacks that allow developers to be notified on specific events.

onInit

Triggered when init has successfully completed and Express is ready for display or further configuration.

SpreedlyExpress.onInit(function() {
  document.getElementById("pay-button").disabled = false;
});

Callback signature

function()

onViewClose

Triggered when the Express view is closed. This callback is invoked when either the user manually closes the view or unload() is called.

SpreedlyExpress.onViewClose(function() {
  console.log('event: view closed');
});

Callback signature

function()

onPaymentMethod

Triggered when a payment method has been successfully tokenized at Spreedly. The resulting payment method token (and any additional data) should now be sent to your backend server environment for transacting.

SpreedlyExpress.onPaymentMethod(function(token, paymentMethod) {

  // Send requisite payment method info to backend
  var tokenField = document.getElementById("payment_method_token");

  tokenField.setAttribute("value", token);

  var masterForm = document.getElementById('payment-form');
  masterForm.submit();
});

Callback signature

function(token, formData)

Arguments

NameDescription
tokenThe token of the newly tokenized payment method. Tokens are alphanumerics in the form M8TBiUmc19cjV16PdMbsj65uViL.
formDataA map of the data entered into the Express payment form, i.e. “full_name” ,“month” ,“year”

Did this page help you?