ClocknextClocknextHelp
DocumentationAPI ReferenceMCP Tools
Dashboard

Get started

OverviewQuickstart

Good to know

Response formatHandling errorsPaginating resultsSending data reliablyYour own customer idsWebhooks

API reference

Signals

Record credit POSTRecord outcome POSTComplete outcome POSTRecord wallet POSTRecord unit POSTComplete composite POSTList raw signals GETRetry signals POSTList Customer Usage Log GETLook Up Usage Logs by ID GET

Deprecated

Record credit POSTRecord outcome POSTComplete outcome POSTRecord wallet POSTRecord unit POSTComplete composite POSTList raw signals GETRetry signals POST

Customers

List customers GETCreate a customer POSTGet a customer GETUpdate a customer PATCHDelete a customer DELETEGet a customer's balances GETGet a customer's wallet ledger GETSet a customer's low-balance alert for wallet PUTGet a customer's current plan GETChange a recurring grant PUTUpdate a customer's card POSTGet a customer's invoice balance GETAdjust a customer's invoice balance POST

Deprecated

List Customer Usage Log GETLook Up Usage Logs by ID GET

Manage

Manage a customer's credit balance POSTManage a customer's outcome balance POSTManage a customer's unit balance POSTManage a customer's composite balance POSTManage a customer's wallet balance POST

Members

List a customer's members GETAdd a member POSTUpdate a member PATCHRemove a member DELETE

Plans and Entitlements

PlansPackagesCreditsOutcomesUnitsComposites

Taxes

List taxes GETCreate a tax POSTGet a tax GETUpdate a tax PATCH

Purchases

List purchases GETCreate a purchase POSTGet a purchase GETUpdate a purchase's auto-payment setting PATCHCancel a purchase POST

Checkout

Create a checkout POST

Subscriptions

List subscriptions GETGet a subscription GETCancel a subscription POSTAdd packages to a subscription POSTRemove a package from a subscription POST

Plan changes

List plan changes GETPreview a plan change POSTChange a customer's plan POSTGet a plan change GET

Invoices

List invoices GETGet an invoice GETMint a hosted pay link GETRecord a payment POST

Credit notes

List credit notes GETCreate a credit note POSTGet a credit note GETVoid a credit note POST

Refunds

List refunds GETRefund to the card POSTGet a refund GET

Payments

List payments GETGet a payment GET

Webhooks

Customer Portal

Mint a customer-portal access token POST

Get a refund

One refund: its status, the gateway's own id, the amount, and what went back to the card in the currency charged.

Base URL https://payments.clocknext.com/api/v1

GET
/refunds/{id}

Authorization

apiKey
headerAuthorizationBearer <cnk_…>

Organisation-scoped key from Settings → API Keys.

Path Parameters

id*string

Refund id.

Response Body

The refund.

application/json
  1. response
  1. response
  2. …
statusCode*integer

The HTTP status code of the response, repeated in the body.

statusDetail*

The status of the request. status is SUCCESS, and message says what happened.

result*

The data of the answer.

Example Request
curl -X GET 'https://payments.clocknext.com/api/v1/refunds/cmvgwd4ef000c08l5h8t3m2ya'
Example Response
{  "statusCode": 200,  "statusDetail": {    "status": "SUCCESS",    "message": "Request processed successfully."  },  "result": {    "refund": {      "id": "cmvgwd4ef000c08l5h8t3m2ya",      "invoiceId": "cmvgvkn14002u08l2ct47s2a7",      "invoiceNumber": "INV-0001",      "customerId": "cmvgva5po000c07iir1vtn8vl",      "creditNoteId": null,      "gateway": "STRIPE",      "gatewayRefundId": "re_3Q9xK2LkdIwHu7ix0aBcD1Ef",      "amountUsd": 40,      "chargedAmountMinor": 4000,      "chargedCurrencyCode": "USD",      "status": "PENDING_AT_GATEWAY",      "failureReason": null,      "reason": "Customer asked for money back",      "createdAt": "2026-10-28T09:20:11.000Z",      "settledAt": null    }  }}

Types

Every object type on this page, with its fields.

Refund

Money going back to a customer's card.

FieldTypeRequiredDescription
idstringyesThe refund's id.
invoiceIdstringyesThe invoice whose payment it goes back to.
invoiceNumberstringyesThat invoice's reference.
customerIdstringyesThe customer.
creditNoteIdstring | nullyesThe credit note it came from. null for a refund of the invoice balance.
gateway"STRIPE" | "PADDLE"yesThe payment gateway that holds the money.
gatewayRefundIdstring | nullyesThe gateway's own id. null until the gateway answers.
amountUsdnumberyesUSD taken out of the invoice balance for it.
chargedAmountMinorinteger | nullyesWhat goes back to the card, in the smallest unit of the charged currency. null until known.
chargedCurrencyCodestring | nullyesThe currency that was charged. null until known.
status"PENDING_AT_GATEWAY" | "SUCCEEDED" | "FAILED" | "REJECTED_IN_GATEWAY_REVIEW"yesPENDING_AT_GATEWAY until the gateway finishes. A failed or rejected refund returns the money.
failureReasonstring | nullyesWhy a FAILED or REJECTED_IN_GATEWAY_REVIEW refund did not go through.
reasonstring | nullyesThe reason you gave. null when none.
createdAtstringyesWhen it was requested.
settledAtstring | nullyesWhen the gateway finished. null while pending.

Refund to the card POST

Sends part of the customer's invoice balance back to their card. Only card credit can go back, never cash or goodwill; a bigger amount is split across payments. It stays `PENDING_AT_GATEWAY` until the gateway finishes. `idempotencyKey` is required.

List payments GET

A payment is a PAID invoice. Newest first, paged with `limit` (at most 50) and `cursor` → `nextCursor` — see [Paginating results](/docs/api-reference/pagination). There is no `status` parameter: Any other query parameter is a `400` ("Unknown parameter `offset`.").