Skip to main content
POST
/
payments
Create a payment
curl --request POST \
  --url https://api.plane.com/v1/payments \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "worker": "<string>",
  "amount": "<string>",
  "currency": "<string>",
  "account": "<string>",
  "date": "<string>",
  "metadata": {},
  "reference": "<string>",
  "note": "<string>",
  "period": {}
}
'
{
  "id": "pt_ogdEjSnSqNYxtW1sd3pC3hFX",
  "worker": "wr_anqRSFcK36ie85",
  "account": "acct_eWDutUkEc5WDzy3eoos1CZyA",
  "amount": "1200.00",
  "currency": "EUR",
  "date": "2023-09-01",
  "metadata": {},
  "reference": "EV1S3GDM",
  "note": "Payment for July",
  "period": {
    "starts": "2023-07-01",
    "ends": "2023-07-31"
  },
  "funding": {
    "amount": "1029.02",
    "currency": "USD"
  }
}

​
Parameters

​
worker
string
required
The ID of an existing worker this payment will be sent to.
​
amount
string
required
The amount of the payment in decimal format.
​
currency
string
required
Three-letter ISO currency code, in uppercase.
​
account
string
ID of the account belong to this worker you want to send the payment to. When omitted, Plane will use the worker’s preferred bank account for a given currency.
​
date
string
The date this payment is scheduled for. When omitted, Plane will pick the soonest available date.
​
metadata
object
Set of key-value pairs that you can attach to an object. This can be useful for storing additional information about the object in a structured format.
​
reference
string
A reference for this payment visible to the worker. When ommitted, Plane will generate a new 8-character reference for each payment.
​
note
string
An additional memo to be included with the payment. Plane will try to include it in payment instructions, so it may be shown on the recipient’s bank statement depending on the payment method used.
​
period
object
An optional period that this payment is associated with.

​
Returns

Returns the Payment object after successful payment creation. Returns an error code if create parameters are invalid. 
{
  "id": "pt_ogdEjSnSqNYxtW1sd3pC3hFX",
  "worker": "wr_anqRSFcK36ie85",
  "account": "acct_eWDutUkEc5WDzy3eoos1CZyA",
  "amount": "1200.00",
  "currency": "EUR",
  "date": "2023-09-01",
  "metadata": {},
  "reference": "EV1S3GDM",
  "note": "Payment for July",
  "period": {
    "starts": "2023-07-01",
    "ends": "2023-07-31"
  },
  "funding": {
    "amount": "1029.02",
    "currency": "USD"
  }
}