CLclover
PAYMENTS

Get all payments for an order

Displays payment information, including the total amount, tip amount, tax amount, and result status for an order.

get/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.

Query parameters

filterstring

Filter fields to display search results: [modifiedTime, device.id, externalReferenceId, result, offline, createdTime, externalPaymentId, voided, id, tender.id, employee.id, order.modifiedTime, amount, cardType, clientCreatedTime]

expandstring

Expandable fields to display additional nested information: [tender, germanInfo, lineItemPayments, cardTransaction, dccInfo, employee, refunds, transactionInfo, externalReferenceId, oceanGatewayInfo, taxRates, additionalCharges, appTracking, paymentAttributes, order]

Headers

User-Agentstring required

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

Response

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.