Add Billing Address

post

https://sandbox.nmi.com/api/v5/customers/{customer_id}/billing

Add a billing address and payment method to an existing customer.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Never Use Real API Keys

Use Sandbox keys with the Try It feature. Do not enter production API keys when testing.

Path Params

customer_id

string

required

The customer vault ID.

Body Params

Billing address and payment method for a customer vault record.

payment_details

required

Payment method for a customer vault billing record. Supports the same retail card-present variants as payment transactions.

string

length ≤ 32

Billing information identifier. If not provided, one will be generated. Max 32 characters.

first_name

string

length ≤ 50

First name

last_name

string

length ≤ 50

Last name

company

string

length ≤ 100

Company name

address1

string

length ≤ 100

Address line 1

address2

string

length ≤ 100

Address line 2

city

string

length ≤ 50

City

state

string

length ≤ 50

State or province. Format: CC

zip

string

length ≤ 20

ZIP or postal code

country

string

length ≤ 2

Country code (ISO 3166-1 alpha-2). Format: CC

phone

string

Phone number

string

Email address

fax

string

length ≤ 50

Fax number

currency

string

length between 3 and 3

ISO 4217 currency code used for payment validation. Defaults to USD when omitted.

priority

integer | null

Priority of the billing address

cardholder_auth

Cardholder authentication data. Use the 3-D Secure variant for EMV authentication results. Use the Decrypted wallet variant for merchant-decrypted Apple Pay or Google Pay, which relays the cryptogram and ECI to the 3-D Secure fields.

Responses

401

Unauthorized

Language

Credentials

Header

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

Never Use Real API Keys

200Billing address added successfully

400Bad Request - Validation Error

404Customer not found