Getting Started

Read up on how to start using Securely's External Launch technology to allow you ultimate flexibility in the customer experience while paying.

Securely's External Launch allows api consumers to generate flows for charging customers and refunding customers. The External launch will allow businesses to seamlessly move between their own systems to Securely by generating urls that can then be presented to users.

External Launch can be used to create a custom flow for a customer to generate a charge or to do a refund. For each flow, create a payload to tell Securely where do direct the customer. The response will be a url that you can use to direct the customer to the location of where the flow should start.

The JSON structure of an external launch is the same. The payloadelement structure is dependent on the type of flow that is being requested.

{
  "traceNumber": "launch-{{current_timestamp}}", // A custom id. returned in redirect
  "redirectUrl": "{{redirectUrl}}", // Url to redirect to after completion of launch
  "flow": "CHARGE", // Type of launch "CHARGE", "REFUND", "STANDALONE_REFUND" 
  "user": { // Securely business user that is performing transaction.
    "externalIdentifier": "123-409887",
    "autoRegister": true,
    "email": "{{userEmail}}",
    "phone": "",
    "firstName": "{{userFN}}",
    "lastName": "{{userLN}}"
  },
  "payload": {} // The data that tells Securely how to direct the url for customer payment
}