Skip to main content
POST
/
ledger
Create a new transaction.
curl --request POST \
  --url https://api.goterminal.xyz/ledger \
  --header 'Content-Type: application/json' \
  --header 'X-Api-Key: <x-api-key>' \
  --data '
{
  "amount": 1000,
  "currency": "USD",
  "data": {},
  "external_id": "ext-12345",
  "from_account_id": "acc-12345",
  "to_account_id": "acc-67890",
  "type": "transfer"
}
'
{
  "description": "Oops...there was an error with your payment method. Please try again.",
  "error": "<string>",
  "success": true
}

Headers

​
X-Api-Key
string
required

API Key

Body

application/json

Transaction Payload

​
amount
integer
required
Example:

1000

​
currency
string
required
Example:

"USD"

​
external_id
string
required
Example:

"ext-12345"

​
from_account_id
string
required
Example:

"acc-12345"

​
to_account_id
string
required
Example:

"acc-67890"

​
type
string
required
Example:

"transfer"

​
data
object

Response

Success

​
description
enum<string>
Available options:
Oops...there was an error with your payment method. Please try again.,
Something went wrong,
Please enter the code we sent you,
Something went wrong on our end. Please reload your app, and contact support if this continues.
​
error
string
​
success
boolean