NMnmi
Payments

Authorization

Process an authorization for a payment. Use in conjunction with the capture endpoint to prepare the payment for settlement.

post/v5/payments/auth

Request

  • Base URL
    https://sandbox.nmi.com/api
  • URL
    https://sandbox.nmi.com/api/v5/payments/auth
  • Auth
    API key in header Authorization

Request body

OR

Response

Success

object'transaction' required

Resource type identifier

idstring required

Payment ID

typestring

Customer's payment type (e.g., 'cc', 'ck', 'cs')

amountstring

Payment amount. Format: x.xx

currencystring

Payment currency (ISO 4217)

auth_codestring

Authorization code

avs_responsestring

Address Verification Service response code

cvv_responsestring

Card Verification Value response

customer_vault_idstring

Customer vault ID associated with the payment

statusstring

Payment status

response'1' | '2' | '3'

Response code: 1 = approved, 2 = declined, 3 = error

response_textstring

Textual description of the operation's result

response_codestring

Processor response code

processor_idstring

Processor ID used for the payment

created_datestring date-time

Payment creation date in UTC ISO 8601 format

updated_datestring date-time

Payment last update date in UTC ISO 8601 format

signature_imagestring

Base64 encoded cardholder signature image. Omitted when no signature was captured. Returned on get and list when the payment was loaded with signature data.

Changes

No recorded changes to this operation across all 1 revision of this API.