Skip to main content
POST
/
v1
/
charges
Create a charge
curl --request POST \
  --url https://api.plane.com/v1/charges \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "payments": [
    "<string>"
  ],
  "source": "<string>",
  "date": "<string>",
  "reference": "<string>",
  "metadata": {}
}
'
{
  "id": "ch_oUEpLsdApEb3EGzEeYTBRvGv",
  "status": "pending"
}
When you create a Payment on Plane, it will not process unless it’s funded. Charges are used to fund payments. You can create a Charge by passing in a list of payments that you’re looking to fund.

​
Parameters

​
payments
string[]
required
A list of payment IDs that you’re attempting to charge.
​
source
string
ID of the Source you will use to fund this Charge. When omitted, your default Source will be used.
​
date
string
The date when you want Plane to collect funds from your bank account. When left blank, Plane will use the closest available date.
​
reference
string
A reference for this charge visible on your bank statement. When ommitted, Plane will generate a new 8-character reference for each charge.
​
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.

​
Returns

Returns the created charge ID and current status. Retrieve the full Charge object with Get a charge. Returns an error code if create parameters are invalid. 
{
  "id": "ch_oUEpLsdApEb3EGzEeYTBRvGv",
  "status": "pending"
}