Accept Blue

In this step you will first create two External credentials, use a special Paytram Flow to convert your API key and PIN into a special encoded format for use with Paytram, and finally create two Named credentials.

Retrieve or create your API keys from the Gateway

You will need 2 keys. Copy these to a separate document so you can reference them in a later step.

  • A Tokenization Key (you will use this key as is)

  • An API Key and Pin number (you will convert this key/pin to an encoded format in the next step)

When creating Key, choose from Tokenzation or API key types

Convert your API Key and Pin to an encoded format

  1. Go to App Launcher > Paytram Accept Blue Settings

  1. Enter your Accept Blue API key and PIN number (Pin is required) and click Generate. You can get these values on the Accept Blue Gateway > Control Panel > Source Management

  1. Copy the generated encoded string (staring with the word "Basic") to your clipboad for use in the next step. You will use this value in Paytram, not the original API key/pin

External Credentials

To create the first credential:

  1. Navigate to Setup > Named Credentials.

  2. Click the External Credentials tab.

  3. Click New.

  4. Enter the following values:

  5. Label and Name: noauth

  6. Authentication Protocol: No Authentication

  7. Click Save.

  8. In the credential record, scroll down to locate the Principals section and click New to create a new Principal record. Add the following values:

  9. Parameter name: blank

  10. Sequence Number: 1

  11. Click Save.

Navigate back to the External Credential tab to create the second External credential.

  1. Click New.

  2. Enter the following values:

    1. Label and Name: AcceptBlueExternal

    2. Authentication Protocol: Custom

  3. Click Save.

  4. In the newly created credential, scroll down to locate the Principals section and click New to create a new Principal. Add the following values:

    1. Parameter name: keys

    2. Sequence Number: 1

  5. Click Add to add an Authentication Parameter. Add the following values:

    1. Name: token

    2. Value: (Paste the value you copied earlier of the Tokenization Key)

  6. Click Save.

Named Credentials

From Setup, navigate to Named Credentials.

In the Named Credentials tab:

  1. Click New and complete the following field values:

    1. Label and Name: ‘AcceptBlue’.

    2. URL field:

      1. Depends on whether you are accessing the Production Enviroment of the Gateway, or the Sandbox enviroment:

        1. Production: https://api.accept.blue/api/v2

        2. Sandbox: https://api.develop.accept.blue/api/v2

    3. Enabled for Callouts: true.

    4. For the External Credential, select the ‘noauth’ credential you previously created.

    5. Select all Callout Options.

    6. Allowed Namespaces for Callouts: ‘paytram’.

  2. Click Save.

  3. In the newly created record, scroll down to the Custom Headers section and click New.

  4. Complete the following field values:

    1. Name: Authorization

    2. Value: paste the ‘Basic’ character string that you copied earlier from the Token Generator Flow.

    3. Sequence Number: 1

  5. Click Save.

Now create the second Named credential.

From the Named Credentials tab:

  1. Click New and complete the following fields:

    1. Label and Name: ‘AcceptBluePaytram’

    2. URL: https://gateway.paytram.io

    3. Enable for Callouts: true

    4. For the External Credential, select the ‘AcceptBlueExternal’ external credential you previously created.

    5. Select all Callout Options.

    6. Allowed Namespaces for Callouts: ‘paytram’.

Click Save.

Permissions

Continue to set permissions

Last updated