To take advantage of our Dynamic Authorization model, your system needs to respond to a request from the Nium One platform.
First reach out to your Nium account manager or Nium support and provide your URL [format:
Nium sends a Delegated Model request payload and receives a response payload with this URL.
The API is in the HTTPS protocol. Allow list Nium's IP address to make sure only Nium is the authorized API sender. Aside from HTTPS, there are encryption keys that you and Nium need to share.
To generate a public and private PGP key for the above requests, take the following steps. These steps generate the keys using Git Bash on Windows.
See the following table for a complete list of the commands used.
|Generate a PGP key
|List PGP secret keys
|Export public key
gpg --output clientfile-public.key --armor --export [[email protected]](mailto:[email protected])
|Export private key
gpg --output clientfile-secret.key --armor --export-secret-key [[email protected]](mailto:[email protected])
1 to set the type of the generated public and private key to RSA.
Set the length of the PGP keys. We recommend setting the length of the keys to
Set how many days the keys will be valid for. Nium recommends
0 = Key does not expire.
Details requested include:
- Name of the key owner
- Email address of the key owner
- Any additional comments for your future reference
Set a passphrase for the private PGP key.
List the generated keys using the
gpg --list-secret-keys\ command.
Once you've generated a pair of PGP keys, take the following steps to export the keys.
$gpg --output company-pgp-public-key.key --armor --export [email protected] command to export your public key.
Running the command creates a file in your home directory with the title
$gpg --output company-pgp-private-key.key --armor --export-secret-key [email protected] command to begin exporting your private key.
When prompted, enter the passphrase you set to export the private key.
Entering your passphrase creates a file in your home directory with the title
Reach out to your Nium account manager or Nium support with your PGP keys ready to share.
Nium sends the authorization request to your integration. The request contains the transaction data and merchant data, so you can authorize or reject the request.
Updated 11 days ago