Activate payment request

PATCH 
/api/payment_requests/:id/activate

Requires the PAYPAL OAuth scope. Finalize a draft payment request. This call creates the PayPal order and sends notifications when applicable.

Request

Path Parameters

id stringrequired

PaymentRequest identifier

Responses

200

OK - The request was processed successfully.

application/json

Schema

Schema

id integer
contactId integer
currencyCode string
amount string
invoiceReference stringnull
invoiceDate stringnull
dueDate stringnull
message stringnull
reminderEnabled boolean
tagIds integer[]
email stringnull
pending boolean

Default value: true

draft boolean
hash string
paymentPageUrl stringnull

Example (from schema)

{
  "id": 42,
  "contactId": 145,
  "currencyCode": "CHF",
  "amount": "5000.50",
  "invoiceReference": "Invoice INV-2026-001",
  "invoiceDate": "2026-04-21",
  "dueDate": "2026-05-01",
  "message": "Please settle this invoice until due date.",
  "reminderEnabled": true,
  "tagIds": [
    1,
    2,
    3
  ],
  "email": "[email protected]",
  "pending": true,
  "draft": true,
  "hash": "a5eb1c1f-a4ad-4a19-ad72-f57ba5acf795",
  "paymentPageUrl": "https://www.paypal.com/checkoutnow?token=XYZ"
}

400

Bad Request -- Your request is invalid.

401

Unauthorised -- Your access token is wrong.

application/json

Schema

Schema

type string
title string
detail string

Example (from schema)

{
  "type": "string",
  "title": "string",
  "detail": "string"
}

403

Forbidden -- Access to the requested resource or action is forbidden.

404

Not Found -- The requested resource could not be found.

422

Unprocessable Content -- We could not process your request due to invalid data provided.

Loading...