Create Sale Transaction

post

https://sandbox.nmi.com/api/v5/payments/sale

Process a sale transaction. This endpoint authorizes and captures the payment in a single step.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

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

required

Payment method details. Exactly one variant: raw card data, ACH (check) data, payment_token, Apple Pay encrypted payload, or Google Pay encrypted payload. Do not combine fields from different variants.

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

200Success

400Bad Request - Validation Error