NMI

Website: www.nmi.com

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.

Enter credentials:

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

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

• 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’.
• Send descriptor
  • Allows sending a custom transaction descriptor to the payment provider. When enabled, the system will use a descriptor value from the transaction payload or a default constant if not provided.
• Address Source
  • This allows you to select the field from which the address is taken for transmission to the provider:
    • Full Address (default)
    • Street (customer.address.street)

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