CreddotDocsCreddot Docs
API referencePayment links

Void an offline Pay Link payment

DELETE
/api/v1/payment-links/{id}/offline-payments/{transactionId}

Authorization

api-key
headerx-api-key<token>

Your API key: ck_test_... for test mode, ck_live_... for live. Send it with x-api-secret (or Authorization: Bearer ).

Path Parameters

id*string
transactionId*string

Header Parameters

x-api-secret?string

Recommended: API secret sent over HTTPS. You may send it as Authorization: Bearer instead. If supplied, x-timestamp and x-signature are not required.

x-timestamp?string

Legacy signed mode: Unix time in milliseconds; maximum clock skew five minutes.

x-signature?string

Legacy signed mode: HMAC-SHA256(secret, timestamp.METHOD.url.idempotencyKey.bodyHash).

x-idempotency-key*string

1–128 letters/digits or ._:-. Same key and payload replay for 24 hours; conflicting, in-flight, or expired keys return 409. Never change a key to retry an uncertain payment.

Response Body

application/json
  1. response
id*string
environment*string
Value in"SANDBOX""LIVE"
slug*string
status*string
Value in"ACTIVE""DISABLED""EXPIRED"
amountMinor*|

Null means the payer chooses an amount.

currency*string
description*string
pageName*string
linkNumber*string
payCode*string
visibility*string
Value in"PUBLIC""PRIVATE"
imageFileId*string|null
customerFields*
customers*array<>
progress*
reusable*boolean

True for standard Pay Links, which accept unlimited payments until disabled or expired. Invoice links are single-use.

customerName*string|null
customerEmail*string|null
redirectUrl*|
Formaturi
reference*string|null
expiresAt*|
Formatdate-time
viewedAt*|
Formatdate-time
disabledAt*|
Formatdate-time
createdAt*string
Formatdate-time
updatedAt*string
Formatdate-time
checkoutPath*string

Public checkout metadata endpoint. A hosted payment page is not included in this backend.

business*
imageUrl*|
Formaturi
imageUrlExpiresAt*|
Formatdate-time
recentActivity*array<>
Example Request
curl -X DELETE 'https://api.creddot.com/api/v1/payment-links/string/offline-payments/string' \  -H 'x-idempotency-key: string'
Example Response
{  "id": "string",  "environment": "SANDBOX",  "slug": "cpl_abc123",  "status": "ACTIVE",  "amountMinor": "500000",  "currency": "NGN",  "description": "string",  "pageName": "string",  "linkNumber": "string",  "payCode": "string",  "visibility": "PUBLIC",  "imageFileId": "string",  "customerFields": {    "customerName": true,    "customerEmail": true,    "customerPhone": true,    "billingAddress": true,    "deliveryAddress": true  },  "customers": [    {      "fullName": "string",      "email": "user@example.com",      "phoneNumber": "string"    }  ],  "progress": {    "collectedAmountMinor": "2000000",    "pendingAmountMinor": "1200000",    "totalAmountMinor": "3200000",    "percentageCompleted": 62.5,    "paymentStatus": "UNPAID",    "successfulPayments": 0  },  "reusable": true,  "customerName": "string",  "customerEmail": "string",  "redirectUrl": "http://example.com",  "reference": "string",  "expiresAt": "2019-08-24T14:15:22Z",  "viewedAt": "2019-08-24T14:15:22Z",  "disabledAt": "2019-08-24T14:15:22Z",  "createdAt": "2019-08-24T14:15:22Z",  "updatedAt": "2019-08-24T14:15:22Z",  "checkoutPath": "/api/v1/checkout/payment-links/cpl_abc123",  "business": {    "name": "string",    "email": "user@example.com"  },  "imageUrl": "http://example.com",  "imageUrlExpiresAt": "2019-08-24T14:15:22Z",  "recentActivity": [    {      "transactionId": "string",      "customerName": "string",      "customerEmail": "user@example.com",      "amountMinor": "1200000",      "paidAt": "2019-08-24T14:15:22Z",      "offline": true    }  ]}