🕹️Simulator

Customer Verifications

Verify Customer

To verify a customer with pending verification and proceed with activation, make a PATCH request to /simulator/customers/{customerId}/verify.

Verify customer

patch

https://api.offblocks.xyz/v1https://api.sandbox.offblocks.xyz/v1

/simulator/customers/{customerId}/verify

Simulates customer verification success

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

customerIdstring · uuidRequired

Unique customer ID

Header parameters

SignaturestringRequired

HTTP message signature

Signature-InputstringRequired

HTTP message signature input

Idempotency-Keystring · uuidRequired

Idempotency key (UUID)

Responses

202

Successful operation

No content

400

Invalid request

401

Not authorised

404

Customer not found

500

Internal error

patch

/simulator/customers/{customerId}/verify

HTTPcURLJavaScriptPython

PATCH /v1/simulator/customers/{customerId}/verify HTTP/1.1
Host: api.offblocks.xyz
Authorization: Bearer YOUR_SECRET_TOKEN
Signature: text
Signature-Input: text
Idempotency-Key: 123e4567-e89b-12d3-a456-426614174000
Accept: */*

No content

Reject Customer

To reject a customer with pending verification, make a PATCH request to /simulator/customers/{customerId}/reject.

Reject customer

patch

https://api.offblocks.xyz/v1https://api.sandbox.offblocks.xyz/v1

/simulator/customers/{customerId}/reject

Simulates customer verification rejection

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

customerIdstring · uuidRequired

Unique customer ID

Header parameters

SignaturestringRequired

HTTP message signature

Signature-InputstringRequired

HTTP message signature input

Idempotency-Keystring · uuidRequired

Idempotency key (UUID)

Responses

202

Successful operation

No content

400

Invalid request

401

Not authorised

404

Customer not found

500

Internal error

patch

/simulator/customers/{customerId}/reject

HTTPcURLJavaScriptPython

PATCH /v1/simulator/customers/{customerId}/reject HTTP/1.1
Host: api.offblocks.xyz
Authorization: Bearer YOUR_SECRET_TOKEN
Signature: text
Signature-Input: text
Idempotency-Key: 123e4567-e89b-12d3-a456-426614174000
Accept: */*

No content

Cards

Issue Card

To approve a pending card issuance request and proceed with activation, make a PATCH request to /simulator/cards/{cardId}/issue.

Issue card

patch

https://api.offblocks.xyz/v1https://api.sandbox.offblocks.xyz/v1

/simulator/cards/{cardId}/issue

Simulates card issuing success

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

cardIdstring · uuidRequired

Unique card ID

Header parameters

SignaturestringRequired

HTTP message signature

Signature-InputstringRequired

HTTP message signature input

Idempotency-Keystring · uuidRequired

Idempotency key (UUID)

Responses

202

Successful operation

No content

400

Invalid request

401

Not authorised

404

Card not found

500

Internal error

patch

/simulator/cards/{cardId}/issue

HTTPcURLJavaScriptPython

PATCH /v1/simulator/cards/{cardId}/issue HTTP/1.1
Host: api.offblocks.xyz
Authorization: Bearer YOUR_SECRET_TOKEN
Signature: text
Signature-Input: text
Idempotency-Key: 123e4567-e89b-12d3-a456-426614174000
Accept: */*

No content

Fail Card Issuance

To fail a pending card issuance request, make a PATCH request to /simulator/cards/{cardId}/fail.

Fail card issuance

patch

https://api.offblocks.xyz/v1https://api.sandbox.offblocks.xyz/v1

/simulator/cards/{cardId}/fail

Simulates card issuing failure

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

cardIdstring · uuidRequired

Unique card ID

Header parameters

SignaturestringRequired

HTTP message signature

Signature-InputstringRequired

HTTP message signature input

Idempotency-Keystring · uuidRequired

Idempotency key (UUID)

Responses

202

Successful operation

No content

400

Invalid request

401

Not authorised

404

Card not found

500

Internal error

patch

/simulator/cards/{cardId}/fail

HTTPcURLJavaScriptPython

PATCH /v1/simulator/cards/{cardId}/fail HTTP/1.1
Host: api.offblocks.xyz
Authorization: Bearer YOUR_SECRET_TOKEN
Signature: text
Signature-Input: text
Idempotency-Key: 123e4567-e89b-12d3-a456-426614174000
Accept: */*

No content

Authorisations

Initiate Card Authorisation

To initiate a card authorisation for a specified card, make a POST request to /simulator/cards/{cardId}/authorisation. You have an option to automatically capture the created authorisation upon approval.

Initiate card authorisation

post

https://api.offblocks.xyz/v1https://api.sandbox.offblocks.xyz/v1

/simulator/cards/{cardId}/authorisation

Simulates card authorisation

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

cardIdstring · uuidRequired

Unique card ID

Header parameters

SignaturestringRequired

HTTP message signature

Signature-InputstringRequired

HTTP message signature input

Idempotency-Keystring · uuidRequired

Idempotency key (UUID)

Content-DigeststringRequired

Content digest

Body

application/json

amountstring · decimalRequired

Amount to be authorised

Example: 10.0

currencystringRequired

Authorisation currency (ISO-4217)

Example: EUR

capturebooleanRequired

Whether to capture the authorisation immediately

Default: true

Responses

201

Successful operation

application/json

400

Invalid request

401

Not authorised

404

Card not found

500

Internal error

post

/simulator/cards/{cardId}/authorisation

HTTPcURLJavaScriptPython

POST /v1/simulator/cards/{cardId}/authorisation HTTP/1.1
Host: api.offblocks.xyz
Authorization: Bearer YOUR_SECRET_TOKEN
Signature: text
Signature-Input: text
Idempotency-Key: 123e4567-e89b-12d3-a456-426614174000
Content-Digest: text
Content-Type: application/json
Accept: */*
Content-Length: 49

{
  "amount": "10.0",
  "currency": "EUR",
  "capture": true
}

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "accountId": "123e4567-e89b-12d3-a456-426614174000",
  "cardId": "123e4567-e89b-12d3-a456-426614174000",
  "status": "pending",
  "amount": "10.0",
  "currency": "EUR",
  "merchantAmount": "10.0",
  "merchantCurrency": "EUR",
  "exchangeRate": "10.0",
  "merchant": {
    "id": "text",
    "name": "text",
    "mcc": 1,
    "country": "text",
    "city": "text"
  },
  "createdAt": "2025-12-16T06:50:36.614Z",
  "updatedAt": "2025-12-16T06:50:36.614Z"
}

Capture Authorisation

To capture a pending card authorisation which was not initiated with automatic capture mode, make a PATCH request to /simulator/authorisations/{authorisationId}/capture.

Capture card authorisation

patch

https://api.offblocks.xyz/v1https://api.sandbox.offblocks.xyz/v1

/simulator/authorisations/{authorisationId}/capture

Simulates card authorisation capture

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

authorisationIdstring · uuidRequired

Unique authorisation ID

Header parameters

SignaturestringRequired

HTTP message signature

Signature-InputstringRequired

HTTP message signature input

Idempotency-Keystring · uuidRequired

Idempotency key (UUID)

Responses

202

Successful operation

No content

400

Invalid request

401

Not authorised

404

Authorisation not found

500

Internal error

patch

/simulator/authorisations/{authorisationId}/capture

HTTPcURLJavaScriptPython

PATCH /v1/simulator/authorisations/{authorisationId}/capture HTTP/1.1
Host: api.offblocks.xyz
Authorization: Bearer YOUR_SECRET_TOKEN
Signature: text
Signature-Input: text
Idempotency-Key: 123e4567-e89b-12d3-a456-426614174000
Accept: */*

No content

Release Authorisation

To release a pending card authorisation which was not initiated with automatic capture mode, make a PATCH request to /simulator/authorisations/{authorisationId}/release.

Release card authorisation

patch

https://api.offblocks.xyz/v1https://api.sandbox.offblocks.xyz/v1

/simulator/authorisations/{authorisationId}/release

Simulates card authorisation release

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

authorisationIdstring · uuidRequired

Unique authorisation ID

Header parameters

SignaturestringRequired

HTTP message signature

Signature-InputstringRequired

HTTP message signature input

Idempotency-Keystring · uuidRequired

Idempotency key (UUID)

Responses

202

Successful operation

No content

400

Invalid request

401

Not authorised

404

Authorisation not found

500

Internal error

patch

/simulator/authorisations/{authorisationId}/release

HTTPcURLJavaScriptPython

PATCH /v1/simulator/authorisations/{authorisationId}/release HTTP/1.1
Host: api.offblocks.xyz
Authorization: Bearer YOUR_SECRET_TOKEN
Signature: text
Signature-Input: text
Idempotency-Key: 123e4567-e89b-12d3-a456-426614174000
Accept: */*

No content