CLclover
REFUNDS

Get a refund

Returns details of a specific refund.

get/v1/refunds/{refundId}

Request

  • Base URL
    https://scl-sandbox.dev.clover.com
  • URL
    https://scl-sandbox.dev.clover.com/v1/refunds/{refundId}
  • Auth
    OAuth 2
    Authorization code: https://sandbox.dev.clover.com/oauth/authorize
    Token URL: https://sandbox.dev.clover.com/oauth/token

Path parameters

refundIdstring required

Universal unique identifier (UUID) of the refund to retrieve.

Headers

User-Agentstring required

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

Response

Successful response. Refund details are displayed.

idstring required

Refund identifier.

amountinteger required

Refund amount from the balance of unrefunded amount of the charge. Format: Cents

createdinteger required

Displays results based on the object's created field. Values: String with a Unix timestamp (in milliseconds). Dictionary of multiple options describing a time range.

currencystring required

Three-letter ISO 4217 currency code.

descriptionstring

Description about the refund.

external_reference_idstring

Unique identifier (ID), such as an invoice or purchase order (PO) number, that is sent to the merchant's gateway and displayed in settlement records. Format: Supported for US—alphanumeric characters with in-between spaces. Length: Max 12, including spaces and alphanumeric characters.

failure_reason'lost_or_stolen_card' | 'expired_or_canceled_card' | 'unknown'

Reason of the cancellation of the refund.

chargestring required

Charge identifier.

metadataobject required

Indicates whether a US merchant with the gateway group Ids 40001 or 10001, and merchant category codes (MCC) 6012 or 6051 can process Visa® consumer debit transactions that have an existing debt. Values: True - Merchant can process transactions that have an existing debt. False - Default; Transactions do not have an existing debt.

object'refund' required

Object of the refund.

reason'duplicate' | 'fraudulent' | 'requested_by_customer' nullable

Reason for the refund.

receipt_numberstring nullable

Transaction receipt number that appears on the receipt emailed for this charge

status'succeeded (card or non-card)' | 'failed (card or non-card)' | 'pending (non-card only)' | 'canceled (non-card only)' nullable required

Status of the refund. Values: For credit cards - succeeded or failed For other methods - pending, succeeded, failed, or canceled

Changes

No recorded changes to this operation across all 1 revision of this API.