v1

latestOpenAPI 3.0.32026-07-2488203535.0 KB

Devices

Create Credit Payment Request on Device

Initiate an asynchronous credit (refund) 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/credit with device_id in the request body. This endpoint uses the same underlying functionality as POST /api/v5/payments/credit.

post/v5/devices/{device_id}/payment-requests/credit

Path parameters

device_idstring required

The unique identifier of the cloud device

Request body

amountnumber required

Total amount to be charged. Format: x.xx

surchargenumber

Surcharge amount. Format: x.xx

convenience_feenumber

Convenience fee amount. Format: x.xx

misc_feenumber

Miscellaneous fee amount. Format: x.xx

misc_fee_namestring

Custom miscellaneous fee name. Default: Miscellaneous Fee

tipnumber

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

currencystring

The ISO 4217 currency code. Example: USD

processor_idstring

If using multiple processors, route to the specified processor ID. Omit for default processor or when using a single processor.

dup_secondsinteger

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

transaction_session_idstring

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

customer_receiptboolean

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

pinless_debit_overrideboolean

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

industry'retail' | 'restaurant' | 'ecommerce' | 'moto' | 'lodging'

Industry type for the payment

signature_imagestring

Base64 encoded signature image

network_tokenizeboolean

Enable network tokenization

partial_payments'settle_partial' | 'payment_in_full'

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

partial_payment_idstring

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

Response

Payment request created successfully

object'payment-request' required

Resource type identifier

idstring required

Payment request ID

status'pending' | 'completed' | 'error' required

Status of the payment request