Sign in

v2

latestOpenAPI 3.0.3raw.githubusercontent.com2025-01-245593419.2 KB
Requests

Decline a request

OAuth scope: request_review.write

This endpoint allows you to decline a pending request. You can get the list of all requests via GET /v2/requests.

Inside Qonto, requests can be listed and declined in the Requests tab.

The impacted request will change status from status = pending to status = declined.

request_type can take 4 different values:

  • flash_cards: a flash card is a non-physical card with a budget and a last day of validity. The card becomes inactive after the budget is totally spent or the last date of validity is past.
  • virtual_cards: a virtual card is a non-physical card with a monthly budget. Card holder can spend that amount every calendar month. Above that, transactions will be refused.
  • transfers: a transfer of money from one Qonto account to another account.
  • multi_transfers: several transfers executed at the same time. A document can be provided to create a multi-transfer which is composed of many different transfers.
post/v2/requests/{request_type}/{id}/decline

Path parameters

idstring required

UUID of the request to be processed.

request_type'flash_cards' | 'virtual_cards' | 'transfers' | 'multi_transfers' required

Type of a request to be declined.

Headers

X-Qonto-Idempotency-Keystring uuid required

The API supports idempotency for safely retrying requests without accidentally performing the same operation twice.

X-Qonto-Staging-Tokenstring

Required only for Sandbox API requests; to get one, please submit the following form: https://getqonto.atlassian.net/servicedesk/customer/portal/5/group/47/create/143.

Request body

declined_notestring text required

Example request

{
  "declined_note": "Contact your manager please"
}

Response

returns a success status code

Example response

{
  "request_virtual_card": {
    "id": "be160c90-058e-487a-b775-5b5cad3992aa",
    "request_type": "virtual_card",
    "initiator_id": "8fdb86eb-8e49-4be8-ab60-658b680629af",
    "approver_id": null,
    "note": "personal needs",
    "declined_note": "Contact your manager please",
    "status": "declined",
    "payment_monthly_limit": "500.00",
    "currency": "EUR",
    "processed_at": null,
    "created_at": "2021-10-11T14:28:28Z"
  }
}