Create a FedNow Payment - Treasury Prime Developer Documentation

Introduction

Account

Account Opening

Cards

Payments

Testing

Utilities

POST

fednow

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",
  "security_context": {
    "device_id": "2f4a3f0005614323a61ac09918d29129",
    "ip_address": "127.0.0.1",
    "user_agent": "Mozilla/5.0"
  }
}'

{
  "account_id": "acct_11kpbg3r130zjwr",
  "amount": "100.00",
  "created_at": "2024-01-01T00:00:00Z",
  "currency": "USD",
  "description": "FedNow transfer 202503243211779688172026683739635",
  "external_account_number": "123456789",
  "external_name": "John Doe",
  "external_routing_number": "987654321",
  "fed_settlement_date": "2024-01-01",
  "id": "fednow_11ky35224fez5zb",
  "memo": "Cherry trees",
  "org_id": "org_acme",
  "payment_id": "202503243211779688172026683739635",
  "payment_type": "credit",
  "status": "pending",
  "updated_at": "2024-01-01T00:00:00Z"
}

Authorizations

Authorization

string

header

required

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

account_id

string

required

ID of the account. Filterable.

amount

string

required

Amount of the payment

bank_id

string

required

ID of the bank. Filterable.

created_at

string

required

When this object was created

currency

string

required

Currency of the payment

external_account_number

string

required

External account number. Filterable.

external_name

string

required

External account name

external_routing_number

string

required

External routing number

fed_settlement_date

string

required

Settlement date from FedNow

org_id

string

required

ID of the organization. Filterable.

payment_id

string

required

FedNow payment ID. Filterable.

payment_type

string

required

One of send or receive

security_context

object

required

Context for this submission

updated_at

string

required

When this object was last updated

description

string

Optional description of the payment

memo

string

Optional memo for the payment

Response

200 - application/json

The fednow created

account_id

string

ID of the account. Filterable.

amount

string

Amount of the payment

bank_id

string

ID of the bank. Filterable.

created_at

string

When this object was created

currency

string

Currency of the payment

description

string

Optional description of the payment

error

string

Error message describing why the payment failed

external_account_number

string

External account number. Filterable.

external_name

string

External account name

external_routing_number

string

External routing number

fed_settlement_date

string

Settlement date from FedNow

string

Unique identifier for object

memo

string

Optional memo for the payment

org_id

string

ID of the organization. Filterable.

payment_id

string

FedNow payment ID. Filterable.

payment_type

string

One of send or receive

security_context

object

Context for this submission

status

string

One of pending, processing, canceled, sent, done or error. Filterable.

updated_at

string

When this object was last updated

List FedNow Payments Fetch 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",
  "security_context": {
    "device_id": "2f4a3f0005614323a61ac09918d29129",
    "ip_address": "127.0.0.1",
    "user_agent": "Mozilla/5.0"
  }
}'

{
  "account_id": "acct_11kpbg3r130zjwr",
  "amount": "100.00",
  "created_at": "2024-01-01T00:00:00Z",
  "currency": "USD",
  "description": "FedNow transfer 202503243211779688172026683739635",
  "external_account_number": "123456789",
  "external_name": "John Doe",
  "external_routing_number": "987654321",
  "fed_settlement_date": "2024-01-01",
  "id": "fednow_11ky35224fez5zb",
  "memo": "Cherry trees",
  "org_id": "org_acme",
  "payment_id": "202503243211779688172026683739635",
  "payment_type": "credit",
  "status": "pending",
  "updated_at": "2024-01-01T00:00:00Z"
}