Public developer API

GET /v1/card-payments/:id

Returns one business-scoped mock payment and its recorded event timeline.

Access

A project-specific API key (Authorization: Bearer dapi_live_...) and its Business ID (X-Business-Id). Rate limited per business (120 calls a minute by default).

AVAILABLE ON 25 DECEMBER 2026. The current development foundation never represents a mock payment as live processing.

The /api/v1/card-payments/:id compatibility prefix is also available.

Example request

curl --request GET \
  --url 'https://production.dutchapi.co/v1/card-payments/ID' \
  --header 'X-Business-Id: YOUR_BUSINESS_ID' \
  --header 'Authorization: Bearer bsk_live_YOUR_BUSINESS_SECRET'

Response 200

{
  "id": "cp_mock_4c8f70a64b22458c8de92f3a",
  "object": "card_payment",
  "merchantReference": "order-1042",
  "amount": 25.5,
  "currency": "USD",
  "status": "pending",
  "customer": {
    "name": "Ada Example",
    "email": "ada@example.com"
  },
  "transactionId": null,
  "refundReference": null,
  "mode": "mock",
  "liveProcessing": false,
  "events": [
    {
      "id": "evt_cp_1",
      "type": "payment.created",
      "mode": "mock"
    },
    {
      "id": "evt_cp_2",
      "type": "payment.pending",
      "mode": "mock"
    }
  ]
}

Errors