Create a payment
curl --request POST \
--url https://payment-gateway.learnagent.cloud/v2/payments \
--header 'Content-Type: application/json' \
--header 'Idempotency-Key: <idempotency-key>' \
--header 'X-Morphosis-Key-Id: <x-morphosis-key-id>' \
--header 'X-Morphosis-Nonce: <x-morphosis-nonce>' \
--header 'X-Morphosis-Signature: <api-key>' \
--header 'X-Morphosis-Signature-Version: <x-morphosis-signature-version>' \
--header 'X-Morphosis-Timestamp: <x-morphosis-timestamp>' \
--data '
{
"external_reference": "<string>",
"requested_amount": {
"currency": "<string>",
"decimal": "<string>",
"minor_units": "<string>"
},
"metadata": {}
}
'import requests
url = "https://payment-gateway.learnagent.cloud/v2/payments"
payload = {
"external_reference": "<string>",
"requested_amount": {
"currency": "<string>",
"decimal": "<string>",
"minor_units": "<string>"
},
"metadata": {}
}
headers = {
"X-Morphosis-Signature-Version": "<x-morphosis-signature-version>",
"X-Morphosis-Key-Id": "<x-morphosis-key-id>",
"X-Morphosis-Timestamp": "<x-morphosis-timestamp>",
"X-Morphosis-Nonce": "<x-morphosis-nonce>",
"X-Morphosis-Signature": "<api-key>",
"Idempotency-Key": "<idempotency-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {
'X-Morphosis-Signature-Version': '<x-morphosis-signature-version>',
'X-Morphosis-Key-Id': '<x-morphosis-key-id>',
'X-Morphosis-Timestamp': '<x-morphosis-timestamp>',
'X-Morphosis-Nonce': '<x-morphosis-nonce>',
'X-Morphosis-Signature': '<api-key>',
'Idempotency-Key': '<idempotency-key>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
external_reference: '<string>',
requested_amount: {currency: '<string>', decimal: '<string>', minor_units: '<string>'},
metadata: {}
})
};
fetch('https://payment-gateway.learnagent.cloud/v2/payments', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://payment-gateway.learnagent.cloud/v2/payments",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'external_reference' => '<string>',
'requested_amount' => [
'currency' => '<string>',
'decimal' => '<string>',
'minor_units' => '<string>'
],
'metadata' => [
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"Idempotency-Key: <idempotency-key>",
"X-Morphosis-Key-Id: <x-morphosis-key-id>",
"X-Morphosis-Nonce: <x-morphosis-nonce>",
"X-Morphosis-Signature: <api-key>",
"X-Morphosis-Signature-Version: <x-morphosis-signature-version>",
"X-Morphosis-Timestamp: <x-morphosis-timestamp>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://payment-gateway.learnagent.cloud/v2/payments"
payload := strings.NewReader("{\n \"external_reference\": \"<string>\",\n \"requested_amount\": {\n \"currency\": \"<string>\",\n \"decimal\": \"<string>\",\n \"minor_units\": \"<string>\"\n },\n \"metadata\": {}\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-Morphosis-Signature-Version", "<x-morphosis-signature-version>")
req.Header.Add("X-Morphosis-Key-Id", "<x-morphosis-key-id>")
req.Header.Add("X-Morphosis-Timestamp", "<x-morphosis-timestamp>")
req.Header.Add("X-Morphosis-Nonce", "<x-morphosis-nonce>")
req.Header.Add("X-Morphosis-Signature", "<api-key>")
req.Header.Add("Idempotency-Key", "<idempotency-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://payment-gateway.learnagent.cloud/v2/payments")
.header("X-Morphosis-Signature-Version", "<x-morphosis-signature-version>")
.header("X-Morphosis-Key-Id", "<x-morphosis-key-id>")
.header("X-Morphosis-Timestamp", "<x-morphosis-timestamp>")
.header("X-Morphosis-Nonce", "<x-morphosis-nonce>")
.header("X-Morphosis-Signature", "<api-key>")
.header("Idempotency-Key", "<idempotency-key>")
.header("Content-Type", "application/json")
.body("{\n \"external_reference\": \"<string>\",\n \"requested_amount\": {\n \"currency\": \"<string>\",\n \"decimal\": \"<string>\",\n \"minor_units\": \"<string>\"\n },\n \"metadata\": {}\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://payment-gateway.learnagent.cloud/v2/payments")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["X-Morphosis-Signature-Version"] = '<x-morphosis-signature-version>'
request["X-Morphosis-Key-Id"] = '<x-morphosis-key-id>'
request["X-Morphosis-Timestamp"] = '<x-morphosis-timestamp>'
request["X-Morphosis-Nonce"] = '<x-morphosis-nonce>'
request["X-Morphosis-Signature"] = '<api-key>'
request["Idempotency-Key"] = '<idempotency-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"external_reference\": \"<string>\",\n \"requested_amount\": {\n \"currency\": \"<string>\",\n \"decimal\": \"<string>\",\n \"minor_units\": \"<string>\"\n },\n \"metadata\": {}\n}"
response = http.request(request)
puts response.read_body{
"payment_id": "<string>",
"external_reference": "<string>",
"requested_amount": {
"currency": "<string>",
"decimal": "<string>",
"minor_units": "<string>"
},
"payment_instructions": {
"network": "<string>",
"asset": "<string>",
"destination": "<string>",
"amount": {
"decimal": "<string>",
"sun": "<string>"
},
"expires_at": "2023-11-07T05:31:56Z"
},
"environment": "<string>",
"metadata": {},
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"settlement": {
"actual_received": {
"decimal": "<string>",
"sun": "<string>"
},
"settled_amount": {
"currency": "<string>",
"decimal": "<string>",
"minor_units": "<string>"
},
"settlement_rate": {
"base_asset": "<string>",
"quote_currency": "<string>",
"quote_minor_units": "<string>",
"base_sun": "<string>"
},
"transaction_hash": "<string>"
},
"failure": {
"message": "<string>"
}
}{
"payment_id": "<string>",
"external_reference": "<string>",
"requested_amount": {
"currency": "<string>",
"decimal": "<string>",
"minor_units": "<string>"
},
"environment": "<string>",
"metadata": {},
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"payment_instructions": {
"network": "<string>",
"asset": "<string>",
"destination": "<string>",
"amount": {
"decimal": "<string>",
"sun": "<string>"
},
"expires_at": "2023-11-07T05:31:56Z"
},
"settlement": {
"actual_received": {
"decimal": "<string>",
"sun": "<string>"
},
"settled_amount": {
"currency": "<string>",
"decimal": "<string>",
"minor_units": "<string>"
},
"settlement_rate": {
"base_asset": "<string>",
"quote_currency": "<string>",
"quote_minor_units": "<string>",
"base_sun": "<string>"
},
"transaction_hash": "<string>"
},
"failure": {
"message": "<string>"
}
}{
"type": "<string>",
"title": "<string>",
"status": 499,
"code": "<string>",
"request_id": "<string>",
"detail": "<string>"
}{
"type": "<string>",
"title": "<string>",
"status": 499,
"code": "<string>",
"request_id": "<string>",
"detail": "<string>"
}{
"type": "<string>",
"title": "<string>",
"status": 499,
"code": "<string>",
"request_id": "<string>",
"detail": "<string>"
}{
"type": "<string>",
"title": "<string>",
"status": 123,
"code": "<string>",
"request_id": "<string>",
"payment_id": "<string>",
"detail": "<string>"
}API reference
Create a payment
POST /v2/payments — create a Stage Sandbox payment.
Create a payment
curl --request POST \
--url https://payment-gateway.learnagent.cloud/v2/payments \
--header 'Content-Type: application/json' \
--header 'Idempotency-Key: <idempotency-key>' \
--header 'X-Morphosis-Key-Id: <x-morphosis-key-id>' \
--header 'X-Morphosis-Nonce: <x-morphosis-nonce>' \
--header 'X-Morphosis-Signature: <api-key>' \
--header 'X-Morphosis-Signature-Version: <x-morphosis-signature-version>' \
--header 'X-Morphosis-Timestamp: <x-morphosis-timestamp>' \
--data '
{
"external_reference": "<string>",
"requested_amount": {
"currency": "<string>",
"decimal": "<string>",
"minor_units": "<string>"
},
"metadata": {}
}
'import requests
url = "https://payment-gateway.learnagent.cloud/v2/payments"
payload = {
"external_reference": "<string>",
"requested_amount": {
"currency": "<string>",
"decimal": "<string>",
"minor_units": "<string>"
},
"metadata": {}
}
headers = {
"X-Morphosis-Signature-Version": "<x-morphosis-signature-version>",
"X-Morphosis-Key-Id": "<x-morphosis-key-id>",
"X-Morphosis-Timestamp": "<x-morphosis-timestamp>",
"X-Morphosis-Nonce": "<x-morphosis-nonce>",
"X-Morphosis-Signature": "<api-key>",
"Idempotency-Key": "<idempotency-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {
'X-Morphosis-Signature-Version': '<x-morphosis-signature-version>',
'X-Morphosis-Key-Id': '<x-morphosis-key-id>',
'X-Morphosis-Timestamp': '<x-morphosis-timestamp>',
'X-Morphosis-Nonce': '<x-morphosis-nonce>',
'X-Morphosis-Signature': '<api-key>',
'Idempotency-Key': '<idempotency-key>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
external_reference: '<string>',
requested_amount: {currency: '<string>', decimal: '<string>', minor_units: '<string>'},
metadata: {}
})
};
fetch('https://payment-gateway.learnagent.cloud/v2/payments', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://payment-gateway.learnagent.cloud/v2/payments",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'external_reference' => '<string>',
'requested_amount' => [
'currency' => '<string>',
'decimal' => '<string>',
'minor_units' => '<string>'
],
'metadata' => [
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"Idempotency-Key: <idempotency-key>",
"X-Morphosis-Key-Id: <x-morphosis-key-id>",
"X-Morphosis-Nonce: <x-morphosis-nonce>",
"X-Morphosis-Signature: <api-key>",
"X-Morphosis-Signature-Version: <x-morphosis-signature-version>",
"X-Morphosis-Timestamp: <x-morphosis-timestamp>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://payment-gateway.learnagent.cloud/v2/payments"
payload := strings.NewReader("{\n \"external_reference\": \"<string>\",\n \"requested_amount\": {\n \"currency\": \"<string>\",\n \"decimal\": \"<string>\",\n \"minor_units\": \"<string>\"\n },\n \"metadata\": {}\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-Morphosis-Signature-Version", "<x-morphosis-signature-version>")
req.Header.Add("X-Morphosis-Key-Id", "<x-morphosis-key-id>")
req.Header.Add("X-Morphosis-Timestamp", "<x-morphosis-timestamp>")
req.Header.Add("X-Morphosis-Nonce", "<x-morphosis-nonce>")
req.Header.Add("X-Morphosis-Signature", "<api-key>")
req.Header.Add("Idempotency-Key", "<idempotency-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://payment-gateway.learnagent.cloud/v2/payments")
.header("X-Morphosis-Signature-Version", "<x-morphosis-signature-version>")
.header("X-Morphosis-Key-Id", "<x-morphosis-key-id>")
.header("X-Morphosis-Timestamp", "<x-morphosis-timestamp>")
.header("X-Morphosis-Nonce", "<x-morphosis-nonce>")
.header("X-Morphosis-Signature", "<api-key>")
.header("Idempotency-Key", "<idempotency-key>")
.header("Content-Type", "application/json")
.body("{\n \"external_reference\": \"<string>\",\n \"requested_amount\": {\n \"currency\": \"<string>\",\n \"decimal\": \"<string>\",\n \"minor_units\": \"<string>\"\n },\n \"metadata\": {}\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://payment-gateway.learnagent.cloud/v2/payments")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["X-Morphosis-Signature-Version"] = '<x-morphosis-signature-version>'
request["X-Morphosis-Key-Id"] = '<x-morphosis-key-id>'
request["X-Morphosis-Timestamp"] = '<x-morphosis-timestamp>'
request["X-Morphosis-Nonce"] = '<x-morphosis-nonce>'
request["X-Morphosis-Signature"] = '<api-key>'
request["Idempotency-Key"] = '<idempotency-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"external_reference\": \"<string>\",\n \"requested_amount\": {\n \"currency\": \"<string>\",\n \"decimal\": \"<string>\",\n \"minor_units\": \"<string>\"\n },\n \"metadata\": {}\n}"
response = http.request(request)
puts response.read_body{
"payment_id": "<string>",
"external_reference": "<string>",
"requested_amount": {
"currency": "<string>",
"decimal": "<string>",
"minor_units": "<string>"
},
"payment_instructions": {
"network": "<string>",
"asset": "<string>",
"destination": "<string>",
"amount": {
"decimal": "<string>",
"sun": "<string>"
},
"expires_at": "2023-11-07T05:31:56Z"
},
"environment": "<string>",
"metadata": {},
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"settlement": {
"actual_received": {
"decimal": "<string>",
"sun": "<string>"
},
"settled_amount": {
"currency": "<string>",
"decimal": "<string>",
"minor_units": "<string>"
},
"settlement_rate": {
"base_asset": "<string>",
"quote_currency": "<string>",
"quote_minor_units": "<string>",
"base_sun": "<string>"
},
"transaction_hash": "<string>"
},
"failure": {
"message": "<string>"
}
}{
"payment_id": "<string>",
"external_reference": "<string>",
"requested_amount": {
"currency": "<string>",
"decimal": "<string>",
"minor_units": "<string>"
},
"environment": "<string>",
"metadata": {},
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"payment_instructions": {
"network": "<string>",
"asset": "<string>",
"destination": "<string>",
"amount": {
"decimal": "<string>",
"sun": "<string>"
},
"expires_at": "2023-11-07T05:31:56Z"
},
"settlement": {
"actual_received": {
"decimal": "<string>",
"sun": "<string>"
},
"settled_amount": {
"currency": "<string>",
"decimal": "<string>",
"minor_units": "<string>"
},
"settlement_rate": {
"base_asset": "<string>",
"quote_currency": "<string>",
"quote_minor_units": "<string>",
"base_sun": "<string>"
},
"transaction_hash": "<string>"
},
"failure": {
"message": "<string>"
}
}{
"type": "<string>",
"title": "<string>",
"status": 499,
"code": "<string>",
"request_id": "<string>",
"detail": "<string>"
}{
"type": "<string>",
"title": "<string>",
"status": 499,
"code": "<string>",
"request_id": "<string>",
"detail": "<string>"
}{
"type": "<string>",
"title": "<string>",
"status": 499,
"code": "<string>",
"request_id": "<string>",
"detail": "<string>"
}{
"type": "<string>",
"title": "<string>",
"status": 123,
"code": "<string>",
"request_id": "<string>",
"payment_id": "<string>",
"detail": "<string>"
}Live Stage Sandbox operation. Requires Morphosis HMAC v2 and a signed
Idempotency-Key. Base URL: https://payment-gateway.learnagent.cloud.Authorizations
Morphosis HMAC v2 authenticates public Payment API requests.
Join exactly seven values with one LF character and no trailing LF:
v2- Uppercase HTTP method
- Raw path and query exactly as received
- Unix timestamp in seconds
- Unique nonce
- Raw
Idempotency-Key, or an empty line for GET - Lowercase hexadecimal SHA-256 of the exact raw request body bytes
Encode the canonical string as UTF-8. Sign it with HMAC-SHA-256 and encode the signature as unpadded base64url. Reject duplicate signed headers before canonicalization.
Headers
Public Payment API signature version. Duplicate values are rejected.
Allowed value:
"v2"Public identifier for the merchant signing key. Duplicate values are rejected.
Required string length:
1 - 128Pattern:
^[A-Za-z0-9][A-Za-z0-9._-]{0,127}$Unix timestamp in whole seconds. Duplicate values are rejected.
Pattern:
^[0-9]{10}$Unique, single-use nonce. Duplicate values are rejected.
Required string length:
16 - 128Pattern:
^[A-Za-z0-9._~-]+$Unpadded base64url HMAC-SHA-256 signature. Duplicate values are rejected.
Pattern:
^[A-Za-z0-9_-]{43}$Original merchant-generated key for one logical Payment. It is signed exactly as received. Duplicate values are rejected.
Required string length:
16 - 128Pattern:
^[A-Za-z0-9][A-Za-z0-9._~-]{15,127}$Body
application/json
Merchant reference retained exactly as validated and never forwarded as a private provider field.
Required string length:
1 - 128Show child attributes
Show child attributes
Merchant-defined string values returned unchanged. The idempotency digest sorts original keys by ascending UTF-8 bytes and preserves each validated value exactly.
Show child attributes
Show child attributes
Response
Payment created with payer instructions.
A definitively created Payment with payer instructions.
Pattern:
^pay_[0-7][0-9A-HJKMNP-TV-Z]{25}$Required string length:
1 - 128Available options:
pending, submission_unknown, paid, denied, cancelled, review_required Allowed value:
"pending"Show child attributes
Show child attributes
Show child attributes
Show child attributes
Sandbox TRON Shasta environment.
Allowed value:
"sandbox"Merchant-defined string values returned unchanged. The idempotency digest sorts original keys by ascending UTF-8 bytes and preserves each validated value exactly.
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Stable gateway failure information. It never contains private provider field names, identifiers, status codes, response bodies, or raw errors.
Show child attributes
Show child attributes
⌘I