Create a FedNow Payment
curl --request POST \
--url https://api.treasuryprime.com/fednow \
--header 'Authorization: Basic <encoded-value>' \
--header 'Content-Type: application/json' \
--data '
{
"account_id": "123456",
"amount": "100.00",
"external_account_number": "123456789",
"external_name": "Jane Doe",
"external_routing_number": "000000000",
"memo": "Invoice #053",
"originator_name": "John Doe",
"security_context": {
"device_id": "2f4a3f0005614323a61ac09918d29129",
"ip_address": "127.0.0.1",
"user_agent": "Mozilla/5.0"
}
}
'import requests
url = "https://api.treasuryprime.com/fednow"
payload = {
"account_id": "123456",
"amount": "100.00",
"external_account_number": "123456789",
"external_name": "Jane Doe",
"external_routing_number": "000000000",
"memo": "Invoice #053",
"originator_name": "John Doe",
"security_context": {
"device_id": "2f4a3f0005614323a61ac09918d29129",
"ip_address": "127.0.0.1",
"user_agent": "Mozilla/5.0"
}
}
headers = {
"Authorization": "Basic <encoded-value>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Basic <encoded-value>', 'Content-Type': 'application/json'},
body: JSON.stringify({
account_id: '123456',
amount: '100.00',
external_account_number: '123456789',
external_name: 'Jane Doe',
external_routing_number: '000000000',
memo: 'Invoice #053',
originator_name: 'John Doe',
security_context: {
device_id: '2f4a3f0005614323a61ac09918d29129',
ip_address: '127.0.0.1',
user_agent: 'Mozilla/5.0'
}
})
};
fetch('https://api.treasuryprime.com/fednow', 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://api.treasuryprime.com/fednow",
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([
'account_id' => '123456',
'amount' => '100.00',
'external_account_number' => '123456789',
'external_name' => 'Jane Doe',
'external_routing_number' => '000000000',
'memo' => 'Invoice #053',
'originator_name' => 'John Doe',
'security_context' => [
'device_id' => '2f4a3f0005614323a61ac09918d29129',
'ip_address' => '127.0.0.1',
'user_agent' => 'Mozilla/5.0'
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Basic <encoded-value>",
"Content-Type: application/json"
],
]);
$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://api.treasuryprime.com/fednow"
payload := strings.NewReader("{\n \"account_id\": \"123456\",\n \"amount\": \"100.00\",\n \"external_account_number\": \"123456789\",\n \"external_name\": \"Jane Doe\",\n \"external_routing_number\": \"000000000\",\n \"memo\": \"Invoice #053\",\n \"originator_name\": \"John Doe\",\n \"security_context\": {\n \"device_id\": \"2f4a3f0005614323a61ac09918d29129\",\n \"ip_address\": \"127.0.0.1\",\n \"user_agent\": \"Mozilla/5.0\"\n }\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Basic <encoded-value>")
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://api.treasuryprime.com/fednow")
.header("Authorization", "Basic <encoded-value>")
.header("Content-Type", "application/json")
.body("{\n \"account_id\": \"123456\",\n \"amount\": \"100.00\",\n \"external_account_number\": \"123456789\",\n \"external_name\": \"Jane Doe\",\n \"external_routing_number\": \"000000000\",\n \"memo\": \"Invoice #053\",\n \"originator_name\": \"John Doe\",\n \"security_context\": {\n \"device_id\": \"2f4a3f0005614323a61ac09918d29129\",\n \"ip_address\": \"127.0.0.1\",\n \"user_agent\": \"Mozilla/5.0\"\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.treasuryprime.com/fednow")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Basic <encoded-value>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"account_id\": \"123456\",\n \"amount\": \"100.00\",\n \"external_account_number\": \"123456789\",\n \"external_name\": \"Jane Doe\",\n \"external_routing_number\": \"000000000\",\n \"memo\": \"Invoice #053\",\n \"originator_name\": \"John Doe\",\n \"security_context\": {\n \"device_id\": \"2f4a3f0005614323a61ac09918d29129\",\n \"ip_address\": \"127.0.0.1\",\n \"user_agent\": \"Mozilla/5.0\"\n }\n}"
response = http.request(request)
puts response.read_body{
"account_id": "acct_11kpbg3r130zjwr",
"amount": "100.00",
"bank_id": "bank_acme",
"created_at": "2024-01-01T00:00:00Z",
"currency": "USD",
"description": "FedNow transfer 202503243211779688172026683739635",
"error": null,
"external_account_number": "123456789",
"external_name": "John Doe",
"external_reject_reason": null,
"external_routing_number": "987654321",
"external_status": "pending",
"fed_settlement_date": "2024-01-01",
"id": "fednow_11ky35224fez5zb",
"memo": "Cherry trees",
"org_id": "org_acme",
"originator_name": "Jane Doe",
"payment_id": "202503243211779688172026683739635",
"payment_type": "debit",
"related_fednow_ids": [
"202503243211779688172026683739633",
"202503243211779688172026683739634"
],
"security_context": {
"device_id": "a1b2c3d4e5f6",
"ip_address": "192.168.1.1",
"user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7)"
},
"status": "pending",
"updated_at": "2024-01-01T00:00:00Z"
}FedNow
Create a FedNow Payment
POST
/
fednow
Create a FedNow Payment
curl --request POST \
--url https://api.treasuryprime.com/fednow \
--header 'Authorization: Basic <encoded-value>' \
--header 'Content-Type: application/json' \
--data '
{
"account_id": "123456",
"amount": "100.00",
"external_account_number": "123456789",
"external_name": "Jane Doe",
"external_routing_number": "000000000",
"memo": "Invoice #053",
"originator_name": "John Doe",
"security_context": {
"device_id": "2f4a3f0005614323a61ac09918d29129",
"ip_address": "127.0.0.1",
"user_agent": "Mozilla/5.0"
}
}
'import requests
url = "https://api.treasuryprime.com/fednow"
payload = {
"account_id": "123456",
"amount": "100.00",
"external_account_number": "123456789",
"external_name": "Jane Doe",
"external_routing_number": "000000000",
"memo": "Invoice #053",
"originator_name": "John Doe",
"security_context": {
"device_id": "2f4a3f0005614323a61ac09918d29129",
"ip_address": "127.0.0.1",
"user_agent": "Mozilla/5.0"
}
}
headers = {
"Authorization": "Basic <encoded-value>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Basic <encoded-value>', 'Content-Type': 'application/json'},
body: JSON.stringify({
account_id: '123456',
amount: '100.00',
external_account_number: '123456789',
external_name: 'Jane Doe',
external_routing_number: '000000000',
memo: 'Invoice #053',
originator_name: 'John Doe',
security_context: {
device_id: '2f4a3f0005614323a61ac09918d29129',
ip_address: '127.0.0.1',
user_agent: 'Mozilla/5.0'
}
})
};
fetch('https://api.treasuryprime.com/fednow', 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://api.treasuryprime.com/fednow",
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([
'account_id' => '123456',
'amount' => '100.00',
'external_account_number' => '123456789',
'external_name' => 'Jane Doe',
'external_routing_number' => '000000000',
'memo' => 'Invoice #053',
'originator_name' => 'John Doe',
'security_context' => [
'device_id' => '2f4a3f0005614323a61ac09918d29129',
'ip_address' => '127.0.0.1',
'user_agent' => 'Mozilla/5.0'
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Basic <encoded-value>",
"Content-Type: application/json"
],
]);
$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://api.treasuryprime.com/fednow"
payload := strings.NewReader("{\n \"account_id\": \"123456\",\n \"amount\": \"100.00\",\n \"external_account_number\": \"123456789\",\n \"external_name\": \"Jane Doe\",\n \"external_routing_number\": \"000000000\",\n \"memo\": \"Invoice #053\",\n \"originator_name\": \"John Doe\",\n \"security_context\": {\n \"device_id\": \"2f4a3f0005614323a61ac09918d29129\",\n \"ip_address\": \"127.0.0.1\",\n \"user_agent\": \"Mozilla/5.0\"\n }\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Basic <encoded-value>")
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://api.treasuryprime.com/fednow")
.header("Authorization", "Basic <encoded-value>")
.header("Content-Type", "application/json")
.body("{\n \"account_id\": \"123456\",\n \"amount\": \"100.00\",\n \"external_account_number\": \"123456789\",\n \"external_name\": \"Jane Doe\",\n \"external_routing_number\": \"000000000\",\n \"memo\": \"Invoice #053\",\n \"originator_name\": \"John Doe\",\n \"security_context\": {\n \"device_id\": \"2f4a3f0005614323a61ac09918d29129\",\n \"ip_address\": \"127.0.0.1\",\n \"user_agent\": \"Mozilla/5.0\"\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.treasuryprime.com/fednow")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Basic <encoded-value>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"account_id\": \"123456\",\n \"amount\": \"100.00\",\n \"external_account_number\": \"123456789\",\n \"external_name\": \"Jane Doe\",\n \"external_routing_number\": \"000000000\",\n \"memo\": \"Invoice #053\",\n \"originator_name\": \"John Doe\",\n \"security_context\": {\n \"device_id\": \"2f4a3f0005614323a61ac09918d29129\",\n \"ip_address\": \"127.0.0.1\",\n \"user_agent\": \"Mozilla/5.0\"\n }\n}"
response = http.request(request)
puts response.read_body{
"account_id": "acct_11kpbg3r130zjwr",
"amount": "100.00",
"bank_id": "bank_acme",
"created_at": "2024-01-01T00:00:00Z",
"currency": "USD",
"description": "FedNow transfer 202503243211779688172026683739635",
"error": null,
"external_account_number": "123456789",
"external_name": "John Doe",
"external_reject_reason": null,
"external_routing_number": "987654321",
"external_status": "pending",
"fed_settlement_date": "2024-01-01",
"id": "fednow_11ky35224fez5zb",
"memo": "Cherry trees",
"org_id": "org_acme",
"originator_name": "Jane Doe",
"payment_id": "202503243211779688172026683739635",
"payment_type": "debit",
"related_fednow_ids": [
"202503243211779688172026683739633",
"202503243211779688172026683739634"
],
"security_context": {
"device_id": "a1b2c3d4e5f6",
"ip_address": "192.168.1.1",
"user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7)"
},
"status": "pending",
"updated_at": "2024-01-01T00:00:00Z"
}Authorizations
basicAuthapiKey
Basic authentication header of the form Basic <encoded-value>, where <encoded-value> is the base64-encoded string username:password.
Body
application/json
The fednow to create
ID of the account. Filterable.
Amount of the payment
Pattern:
^[0-9]+[.][0-9][0-9]$External account number. Filterable.
External account name
External routing number
Optional description of the payment
Optional memo for the payment
Optional sender name for the payment
Context for this submission
Show child attributes
Show child attributes
Response
200 - application/json
The fednow created
ID of the account. Filterable.
Amount of the payment
Pattern:
^[0-9]+[.][0-9][0-9]$ID of the bank. Filterable.
When this object was created
Currency of the payment
Optional description of the payment
Error message describing why the payment failed
External account number. Filterable.
External account name
Rejection reason information for rejected payments. Only present for payments rejected by FedNow or counterparty.
Show child attributes
Show child attributes
External routing number
Status of originated payment at the external account. Only populated for sent payments. One of pending, processing, done, rejected, blocked, or error. Filterable.
Settlement date from FedNow
Unique identifier for object
Optional memo for the payment
ID of the organization. Filterable.
Optional sender name for the payment
FedNow payment ID. Filterable.
One of credit or debit
An array of IDs for related FedNow payments
Context for this submission
Show child attributes
Show child attributes
One of pending, processing, sent, done, or error. The available values for status are driven by payment type. Successful credits (incoming) terminate in done. Debits (outgoing) terminate in sent. Filterable.
When this object was last updated
Was this page helpful?