Create Authorization Payment Request on Device

post

https://sandbox.nmi.com/api/v5/devices/{device_id}/payment-requests/auth

Initiate an asynchronous authorization payment request on a specific cloud device. The device_id is specified in the URL path. Payment details (card number, expiration, CVV) are collected by the device itself, so they should not be included in the request body. This endpoint always operates in asynchronous mode. For synchronous payment processing with a device, use POST /api/v5/payments/auth with device_id in the request body. This endpoint uses the same underlying functionality as POST /api/v5/payments/auth.

Path Params

device_id

string

required

The unique identifier of the cloud device

Body Params

Payment request body. Payment details (payment_details object with card_number, card_exp, cvv) should not be included as the device will collect this information from the customer.

amount

number

required

Total amount to be charged. Format: x.xx

surcharge

number

≥ 0

Surcharge amount. Format: x.xx

convenience_fee

number

≥ 0

Convenience fee amount. Format: x.xx

misc_fee

number

≥ 0

Miscellaneous fee amount. Format: x.xx

misc_fee_name

string

length ≤ 50

Custom miscellaneous fee name. Default: Miscellaneous Fee

tip

number

≥ 0

The final tip amount, included in the transaction. Format: x.xx

currency

string

length between 3 and 3

The transaction currency. Format: ISO 4217

processor_id

string

length ≤ 50

If using Multiple MIDs, route to this processor (processor_id is obtained under Settings > Transaction Routing in the Control Panel)

dup_seconds

integer

0 to 7862400

Sets the time in seconds for duplicate transaction checking on supported processors. Set to 0 to disable duplicate checking

transaction_session_id

string

length between 32 and 32

A single use session ID used by Kount to link the transaction and Data Collector information together

customer_receipt

boolean

If set to true, when the customer is charged, they will be sent a transaction receipt

pinless_debit_override

boolean

Set to true if you have Pinless Debit Conversion enabled but want to opt out for this transaction

industry

string

enum

Industry type for the transaction

Allowed:

signature_image

string

Base64 encoded signature image

network_tokenize

boolean

Enable network tokenization

partial_payments

string

enum

settle_partial: Settles any amount of tender collected at cut off. payment_in_full: Required that any split tendered transaction is collected in-full before settlement gets initiated

Allowed:

partial_payment_id

string

length ≤ 50

A numeric identifier which is used when submitting subsequent transactions for partial payments

payment_details

object

required

Payment method details for credit card, ACH, or tokenized payments

billing_address

object

Billing address information for REST API payment transactions

shipping_address

object

Shipping address information for REST API payment transactions

order_details

object

Order details and line items for REST API payment transactions

payment_facilitator

object

Payment facilitator information for submerchant transactions

payment_descriptor

object

Payment descriptor information for transaction statements

cardholder_auth

object

3D Secure cardholder authentication information

merchant_defined_fields

object

Custom fields that can be set up in merchant control panel under Settings->Merchant Defined Fields

customer_vault

object

Customer vault information for storing payment methods

cit_mit

object

Customer Initiated Transaction / Merchant Initiated Transaction information

Responses

401

Unauthorized

200Payment request created successfully

400Bad Request - Validation Error

404Device not found