CLclover
ORDERS

Create a payment record on an order

Payment must include a positive amount and a valid tender ID. Note: This endpoint references external tenders and logs them for bookkeeping purposes. This is not for Clover credits/debit tenders. A merchant's tenders and their IDs can be retrieved from /v3/merchants/mId/tenders.

post/v3/merchants/{mId}/orders/{orderId}/payments

Request

  • Base URL
    https://apisandbox.dev.clover.com
  • URL
    https://apisandbox.dev.clover.com/v3/merchants/{mId}/orders/{orderId}/payments
  • Auth
    HTTP bearer

Path parameters

mIdstring required

Merchant identifier.

orderIdstring required

Order identifier.

Headers

User-Agentstring required

Identifies the application, operating system, vendor, and/or version of the requesting user agent. Format: <product> / <product-version> <comment>

Request body

idstring

13-digits unique identifier of the Merchant.

amountinteger

Total amount paid.

tipAmountinteger

Tip amount paid.

taxAmountinteger

Tax amount paid.

cashbackAmountinteger

Cash amount given by the customer to the merchant.

cashTenderedinteger

Payment amount given by the customer.

externalPaymentIdstring

External payment identifier.

createdTimeinteger

Time when payment was recorded on the server.

clientCreatedTimeinteger

Time when payment was recorded on the client server.

gatewayProcessingTimeinteger

Time when the transaction was processed by the payment gateway.

modifiedTimeinteger

Last modified time of the payment.

offlineboolean

Indicates if the tender option is offline.

result'SUCCESS' | 'FAIL' | 'INITIATED' | 'VOIDED' | 'VOIDING' | 'VOID_FAILED' | 'AUTH' | 'AUTH_COMPLETED' | 'DISCOUNT' | 'OFFLINE_RETRYING' | 'PENDING'

Indicates the result of the tender. Values: Success, fail, initiated, voided, voiding, void_failed, auth, auth_completed, discount, offline_retrying, and pending.

notestring

Note for the refund.

voidReason'USER_CANCEL' | 'TRANSPORT_ERROR' | 'REJECT_SIGNATURE' | 'REJECT_PARTIAL_AUTH' | 'NOT_APPROVED' | 'FAILED' | 'AUTH_CLOSED_NEW_CARD' | 'DEVELOPER_PAY_PARTIAL_AUTH' | 'REJECT_DUPLICATE' | 'REJECT_OFFLINE' | 'GIFTCARD_LOAD_FAILED' | 'USER_GIFTCARD_LOAD_CANCEL' | 'DEVELOPER_PAY_TIP_ADJUST_FAILED' | 'USER_CUSTOMER_CANCEL' | 'FRAUD' | 'REJECT_GREATER_APPROVED_AMOUNT' | 'TIMEOUT'

If voided, the reason for the payment void, if available.

externalReferenceIdstring

External reference identifier (ID) if associated with the payment.

Changes

No recorded changes to this operation across all 2 revisions of this API.