Skip to main content
POST
/
v1
/
payment-requests
/
{id}
/
decline
Decline a payment request
curl --request POST \
  --url https://api.plane.com/v1/payment-requests/{id}/decline \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "approver": "<string>",
  "reason": "<string>"
}
'
{
  "id": "ptr_ogdEjSnSqNYxtW1sd3pC3hFX",
  "worker": "wr_anqRSFcK36ie85",
  "amount": "1200.00",
  "currency": "EUR",
  "status": "declined",
  "reference": "EV1S3GDM",
  "note": "Payment for July",
  "period": {
    "starts": "2023-07-01",
    "ends": "2023-07-31"
  },
  "documents": [],
  "approvals": ["appr_YzmQ5oxQE78bDV3fZwEU3vGr"],
  "payment": null
}
Declines a payment request and sends it back to the worker.

​
Parameters

​
id
string
required
The ID of the payment request you are declining.
​
approver
string
required
The UUID of the manager declining this request.
​
reason
string
required
A description of why the request was declined, visible to the worker.

​
Returns

Returns the Payment Request object with a declined status. 
{
  "id": "ptr_ogdEjSnSqNYxtW1sd3pC3hFX",
  "worker": "wr_anqRSFcK36ie85",
  "amount": "1200.00",
  "currency": "EUR",
  "status": "declined",
  "reference": "EV1S3GDM",
  "note": "Payment for July",
  "period": {
    "starts": "2023-07-01",
    "ends": "2023-07-31"
  },
  "documents": [],
  "approvals": ["appr_YzmQ5oxQE78bDV3fZwEU3vGr"],
  "payment": null
}