Add Billing Address

post

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

Add a new billing address to an existing customer.

Path Params

customer_id

string

required

The customer vault ID.

Body Params

method

string

enum

Can be set to 'recurring' to mark payment as a recurring transaction or 'installment' to mark payment as an installment transaction

Allowed:

number

integer

0 to 99

Specify installment billing number, on supported processors. For use when billing.method is set to "installment"

total

number

≥ 0

Specify installment billing total on supported processors. For use when billing.method is set to "installment"

first_name

string

length ≤ 50

Cardholder's first name

last_name

string

length ≤ 50

Cardholder's last name

company

string

length ≤ 100

Cardholder's company

address1

string

length ≤ 100

Card billing address

address2

string

length ≤ 100

Card billing address, line 2

city

string

length ≤ 50

Card billing city

state

string

length ≤ 50

Card billing state. Format: CC

zip

string

length ≤ 20

Card billing zip code

country

string

length ≤ 2

Card billing country. Country codes are as shown in ISO 3166-1 alpha-2. Format: CC

phone

string

Billing phone number

string

Billing email address

fax

string

length ≤ 50

Billing fax number

cell_phone

string

Billing cell phone number

website

string

length ≤ 255

Website (invoice-specific field)

drivers_license_number

string

length ≤ 20

Driver's license number

drivers_license_dob

string

Driver's license date of birth. Format: YYYY-MM-DD

drivers_license_state

string

length ≤ 2

Driver's license state. Format: CC

Responses

401

Unauthorized

Language

Credentials

Header

Response

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

application/json

200Billing address added successfully

400Bad Request - Validation Error

404Customer not found