curl --request POST \
--url 'https://gateway.amana.io/payments/client/checkout/session/submit' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"id": "<string>",
"amount": 123.45,
"currency": "<string>",
"session_data": "<string>",
"metadata": {}
}'
import requests
url = "https://gateway.amana.io/payments/client/checkout/session/submit"
headers = {"Authorization": "Bearer <token>", "Content-Type": "application/json"}
payload = {
"id": "<string>",
"amount": 123.45,
"currency": "<string>",
"session_data": "<string>",
"metadata": {}
}
response = requests.request("POST", url, json=payload, headers=headers)
print(response.json())
const response = await fetch('https://gateway.amana.io/payments/client/checkout/session/submit', {
method: 'POST',
headers: {"Authorization": "Bearer <token>", "Content-Type": "application/json"},
body: JSON.stringify({"id": "<string>", "amount": 123.45, "currency": "<string>", "session_data": "<string>", "metadata": {}}),
});
console.log(await response.json());
{
"success": true,
"data": {}
}
{
"error": "<string>",
"message": "<string>",
"details": {}
}
{
"error": "<string>",
"message": "<string>",
"details": {}
}
{
"error": "<string>",
"message": "<string>"
}
{
"error": "<string>",
"message": "<string>"
}
{
"error": "<string>",
"message": "<string>"
}
{
"error": "<string>",
"message": "<string>"
}
{
"error": "<string>",
"message": "<string>"
}
Funding
Submit card payment session
Submit the card payment session to complete the deposit.
POST
/
payments
/
client
/
checkout
/
session
/
submit
curl --request POST \
--url 'https://gateway.amana.io/payments/client/checkout/session/submit' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"id": "<string>",
"amount": 123.45,
"currency": "<string>",
"session_data": "<string>",
"metadata": {}
}'
import requests
url = "https://gateway.amana.io/payments/client/checkout/session/submit"
headers = {"Authorization": "Bearer <token>", "Content-Type": "application/json"}
payload = {
"id": "<string>",
"amount": 123.45,
"currency": "<string>",
"session_data": "<string>",
"metadata": {}
}
response = requests.request("POST", url, json=payload, headers=headers)
print(response.json())
const response = await fetch('https://gateway.amana.io/payments/client/checkout/session/submit', {
method: 'POST',
headers: {"Authorization": "Bearer <token>", "Content-Type": "application/json"},
body: JSON.stringify({"id": "<string>", "amount": 123.45, "currency": "<string>", "session_data": "<string>", "metadata": {}}),
});
console.log(await response.json());
{
"success": true,
"data": {}
}
{
"error": "<string>",
"message": "<string>",
"details": {}
}
{
"error": "<string>",
"message": "<string>",
"details": {}
}
{
"error": "<string>",
"message": "<string>"
}
{
"error": "<string>",
"message": "<string>"
}
{
"error": "<string>",
"message": "<string>"
}
{
"error": "<string>",
"message": "<string>"
}
{
"error": "<string>",
"message": "<string>"
}
Body
Content type:application/json
string
required
ID of the item to act on.
number
Amount of money for this request.
string
Currency code, for example USD.
string
required
object
Response
200 Success.
boolean
object
Possible Errors
| Error | Possible cause | What to do |
|---|---|---|
| 400 | Invalid or missing field, amount outside limits | Check the request against the schema and the instrument’s size limits. |
| 401 | Token missing or expired | Log in again or use the refresh token. |
| 403 | IP not whitelisted, or account restricted | Confirm your IP is whitelisted; otherwise contact Amana. |
| 409 / 422 | Market closed, insufficient balance or margin | Check trading hours and balance, then retry. |
| 429 / 5xx | Rate limit, or temporary issue on our side | Retry with backoff; contact support if it persists. |
curl --request POST \
--url 'https://gateway.amana.io/payments/client/checkout/session/submit' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"id": "<string>",
"amount": 123.45,
"currency": "<string>",
"session_data": "<string>",
"metadata": {}
}'
import requests
url = "https://gateway.amana.io/payments/client/checkout/session/submit"
headers = {"Authorization": "Bearer <token>", "Content-Type": "application/json"}
payload = {
"id": "<string>",
"amount": 123.45,
"currency": "<string>",
"session_data": "<string>",
"metadata": {}
}
response = requests.request("POST", url, json=payload, headers=headers)
print(response.json())
const response = await fetch('https://gateway.amana.io/payments/client/checkout/session/submit', {
method: 'POST',
headers: {"Authorization": "Bearer <token>", "Content-Type": "application/json"},
body: JSON.stringify({"id": "<string>", "amount": 123.45, "currency": "<string>", "session_data": "<string>", "metadata": {}}),
});
console.log(await response.json());
{
"success": true,
"data": {}
}
{
"error": "<string>",
"message": "<string>",
"details": {}
}
{
"error": "<string>",
"message": "<string>",
"details": {}
}
{
"error": "<string>",
"message": "<string>"
}
{
"error": "<string>",
"message": "<string>"
}
{
"error": "<string>",
"message": "<string>"
}
{
"error": "<string>",
"message": "<string>"
}
{
"error": "<string>",
"message": "<string>"
}
Last modified on October 8, 2026
