NMI¶

Powering Every Possibility in Payments

Set up Account H2H merchant account¶

Step 1: Create Merchant Account¶

To create an account send connection request at the www.nmi.com/talk-to-our-team or contact manager directly. Submit the required documents to verify your account and gain access.

Step 2: Get required credentials¶

Credentials that have to be issued:

nmi__api_key → API Key
nmi__callback_secret_key → Callback Secret Key
nmi__save_instant_token → Save instant token
nmi__currency → choose currency (You can set these parameters according to available currencies and features for your NMI wallets and services, but it's necessary to check details of the connection with your Corefy account manager.)

Connect Merchant Account¶

Step 1. Connect H2H account at the Corefy Dashboard¶

Press Connect at NMI Provider Overview page in 'New connection' section and choose H2H Merchant account option to open Connection form.

Connect

Enter credentials:

API Key
Callback Secret Key
Save instant token → true/false
Currency

Success

You have connected NMI H2H merchant account!

API examples:¶

Minimum data set to create a payment invoices for payment_card_eur_hpp service¶

SALE
{
  "data":{
    "type":"payment-invoice",
    "attributes":{
      "service":"payment_card_eur_hpp",
      "commerce_account":"hello_world",
      "currency":"EUR",
      "amount":0.1,
      "flow":"charge",
      "gateway_options":{
        "cardgate":{
          "tokenize":""
        }
      },
      "customer":{
        "reference_id":"123456"
      },
      "test_mode":false,
      "options":{
        "allow_partially":true,
        "bypass_hpp":false,
        "send_operation_context_on_return":false
      },
      "reference_id":"b0d142b1-d615-403b-8932-53cfd4342d89",
      "service_fields":[
      ]
    }
  }
}

Provider Options¶

Provider_Options

Retry sale on customer duplicate
- If a Duplicate Customer Vault Id error is received during a Sale transaction and this option is enabled, the system will automatically repeat the request with ‘update_customer’ instead of ‘add_customer’.
Retry auth on customer duplicate
- If a Duplicate Customer Vault Id error is received during an Auth transaction and this option is enabled, the system will automatically repeat the request with ‘update_customer’ instead of ‘add_customer’.

Question

"Still looking for help connecting your NMI account?" Please contact our support team!