Inbound FedNow Transfers

An Inbound FedNow Transfer is a FedNow transfer initiated outside of Increase to your account.

Events

Your application can listen to webhooks about this resource. The events about Inbound FedNow Transfers will have the categories "inbound_fednow_transfer.created" or "inbound_fednow_transfer.updated" .

The Inbound FedNow Transfer object

{
  "account_id": "account_in71c4amph0vgo2qllky",
  "account_number_id": "account_number_v18nkfqm6afpsrvy82b2",
  "amount": 100,
  "confirmation": {
    "transfer_id": "inbound_fednow_transfer_ctxxbc07oh5ke5w1hk20"
  },
  "created_at": "2020-01-31T23:59:59Z",
  "creditor_name": "Ian Crease",
  "currency": "USD",
  "debtor_account_number": "987654321",
  "debtor_name": "National Phonograph Company",
  "debtor_routing_number": "101050001",
  "decline": {
    "reason": "account_number_disabled",
    "transfer_id": "inbound_fednow_transfer_ctxxbc07oh5ke5w1hk20"
  },
  "id": "inbound_fednow_transfer_ctxxbc07oh5ke5w1hk20",
  "status": "confirmed",
  "transaction_id": "transaction_uyrp7fld2ium70oa7oi",
  "type": "inbound_fednow_transfer",
  "unstructured_remittance_information": "Invoice 29582"
}

Attributes

account_id

string

The Account to which the transfer was sent.

More about Accounts.

account_number_id

string

The identifier of the Account Number to which this transfer was sent.

More about Account Numbers.

amount

integer

The amount in USD cents.

confirmation

dictionary

Nullable

If your transfer is confirmed, this will contain details of the confirmation.

created_at

string

The ISO 8601 date and time at which the transfer was created.

creditor_name

string

The name the sender of the transfer specified as the recipient of the transfer.

currency

enum

The ISO 4217 code of the transfer’s currency. This will always be “USD” for a FedNow transfer.

debtor_account_number

string

The account number of the account that sent the transfer.

debtor_name

string

The name provided by the sender of the transfer.

debtor_routing_number

string

The routing number of the account that sent the transfer.

decline

dictionary

Nullable

If your transfer is declined, this will contain details of the decline.

string

The inbound FedNow transfer’s identifier.

status

enum

The lifecycle status of the transfer.

transaction_id

string

Nullable

The identifier of the Transaction object created when the transfer was confirmed.

More about Transactions.

type

string

A constant representing the object’s type. For this resource it will always be inbound_fednow_transfer.

unstructured_remittance_information

string

Nullable

Additional information included with the transfer.

List Inbound FedNow Transfers

curl \
  --url "${INCREASE_URL}/inbound_fednow_transfers?account_id=account_in71c4amph0vgo2qllky" \
  -H "Authorization: Bearer ${INCREASE_API_KEY}"

import Increase from 'increase';

const client = new Increase({
  apiKey: process.env['INCREASE_API_KEY'], // This is the default and can be omitted
});

// Automatically fetches more pages as needed.
for await (const inboundFednowTransfer of client.inboundFednowTransfers.list()) {
  console.log(inboundFednowTransfer.id);
}

import os
from increase import Increase

client = Increase(
    api_key=os.environ.get("INCREASE_API_KEY"),  # This is the default and can be omitted
)
page = client.inbound_fednow_transfers.list()
page = page.data[0]
print(page.id)

require "increase"

increase = Increase::Client.new(
  api_key: ENV["INCREASE_API_KEY"] # This is the default and can be omitted
)

page = increase.inbound_fednow_transfers.list

puts(page)

package main

import (
	"context"
	"fmt"
	"os"

	"github.com/Increase/increase-go"
	"github.com/Increase/increase-go/option"
)

func main() {
	client := increase.NewClient(
		option.WithAPIKey(os.Getenv("INCREASE_API_KEY")), // This is the default and can be omitted
	)
	page, err := client.InboundFednowTransfers.List(context.TODO(), increase.InboundFednowTransferListParams{})
	if err != nil {
		panic(err.Error())
	}
	fmt.Printf("%+v\n", page)
}

package com.increase.api.example;

import com.increase.api.client.IncreaseClient;
import com.increase.api.client.okhttp.IncreaseOkHttpClient;
import com.increase.api.models.inboundfednowtransfers.InboundFednowTransferListPage;
import com.increase.api.models.inboundfednowtransfers.InboundFednowTransferListParams;

public final class Main {
    private Main() {}

    public static void main(String[] args) {
        IncreaseClient client = IncreaseOkHttpClient.fromEnv();

        InboundFednowTransferListPage page = client.inboundFednowTransfers().list();
    }
}

package com.increase.api.example

import com.increase.api.client.IncreaseClient
import com.increase.api.client.okhttp.IncreaseOkHttpClient
import com.increase.api.models.inboundfednowtransfers.InboundFednowTransferListPage
import com.increase.api.models.inboundfednowtransfers.InboundFednowTransferListParams

fun main() {
    val client: IncreaseClient = IncreaseOkHttpClient.fromEnv()

    val page: InboundFednowTransferListPage = client.inboundFednowTransfers().list()
}

<?php

require_once dirname(__DIR__) . '/vendor/autoload.php';

use Increase\Client;
use Increase\Core\Exceptions\APIException;

$client = new Client(apiKey: getenv('INCREASE_API_KEY'));

try {
  $page = $client->inboundFednowTransfers->list(
    accountID: 'account_id',
    accountNumberID: 'account_number_id',
    createdAt: [
      'after' => new \DateTimeImmutable('2019-12-27T18:11:19.117Z'),
      'before' => new \DateTimeImmutable('2019-12-27T18:11:19.117Z'),
      'onOrAfter' => new \DateTimeImmutable('2019-12-27T18:11:19.117Z'),
      'onOrBefore' => new \DateTimeImmutable('2019-12-27T18:11:19.117Z'),
    ],
    cursor: 'cursor',
    limit: 1,
  );

  var_dump($page);
} catch (APIException $e) {
  echo $e->getMessage();
}

using System;
using Increase.Api;
using Increase.Api.Models.InboundFednowTransfers;

IncreaseClient client = new();

InboundFednowTransferListParams parameters = new();

var page = await client.InboundFednowTransfers.List(parameters);
await foreach (var item in page.Paginate())
{
    Console.WriteLine(item);
}

Returns a list response :

{
  "data": [
    { /* Inbound FedNow Transfer object */ },
    { /* Inbound FedNow Transfer object */ }
    /* ... */
  ],
  "next_cursor": "v57w5d",
}

Parameters

account_id

string

Filter Inbound FedNow Transfers to those belonging to the specified Account.

More about Accounts.

account_number_id

string

Filter Inbound FedNow Transfers to ones belonging to the specified Account Number.

More about Account Numbers.

cursor

string

limit

integer

created_at.after

string

created_at.before

string

created_at.on_or_after

string

created_at.on_or_before

string

Retrieve an Inbound FedNow Transfer

curl \
  --url "${INCREASE_URL}/inbound_fednow_transfers/inbound_fednow_transfer_ctxxbc07oh5ke5w1hk20" \
  -H "Authorization: Bearer ${INCREASE_API_KEY}"

import Increase from 'increase';

const client = new Increase({
  apiKey: process.env['INCREASE_API_KEY'], // This is the default and can be omitted
});

const inboundFednowTransfer = await client.inboundFednowTransfers.retrieve(
  'inbound_fednow_transfer_ctxxbc07oh5ke5w1hk20',
);

console.log(inboundFednowTransfer.id);

import os
from increase import Increase

client = Increase(
    api_key=os.environ.get("INCREASE_API_KEY"),  # This is the default and can be omitted
)
inbound_fednow_transfer = client.inbound_fednow_transfers.retrieve(
    "inbound_fednow_transfer_ctxxbc07oh5ke5w1hk20",
)
print(inbound_fednow_transfer.id)

require "increase"

increase = Increase::Client.new(
  api_key: ENV["INCREASE_API_KEY"] # This is the default and can be omitted
)

inbound_fednow_transfer = increase.inbound_fednow_transfers.retrieve("inbound_fednow_transfer_ctxxbc07oh5ke5w1hk20")

puts(inbound_fednow_transfer)

package main

import (
	"context"
	"fmt"
	"os"

	"github.com/Increase/increase-go"
	"github.com/Increase/increase-go/option"
)

func main() {
	client := increase.NewClient(
		option.WithAPIKey(os.Getenv("INCREASE_API_KEY")), // This is the default and can be omitted
	)
	inboundFednowTransfer, err := client.InboundFednowTransfers.Get(context.TODO(), "inbound_fednow_transfer_ctxxbc07oh5ke5w1hk20")
	if err != nil {
		panic(err.Error())
	}
	fmt.Printf("%+v\n", inboundFednowTransfer.ID)
}

package com.increase.api.example;

import com.increase.api.client.IncreaseClient;
import com.increase.api.client.okhttp.IncreaseOkHttpClient;
import com.increase.api.models.inboundfednowtransfers.InboundFednowTransfer;
import com.increase.api.models.inboundfednowtransfers.InboundFednowTransferRetrieveParams;

public final class Main {
    private Main() {}

    public static void main(String[] args) {
        IncreaseClient client = IncreaseOkHttpClient.fromEnv();

        InboundFednowTransfer inboundFednowTransfer = client.inboundFednowTransfers().retrieve("inbound_fednow_transfer_ctxxbc07oh5ke5w1hk20");
    }
}

package com.increase.api.example

import com.increase.api.client.IncreaseClient
import com.increase.api.client.okhttp.IncreaseOkHttpClient
import com.increase.api.models.inboundfednowtransfers.InboundFednowTransfer
import com.increase.api.models.inboundfednowtransfers.InboundFednowTransferRetrieveParams

fun main() {
    val client: IncreaseClient = IncreaseOkHttpClient.fromEnv()

    val inboundFednowTransfer: InboundFednowTransfer = client.inboundFednowTransfers().retrieve("inbound_fednow_transfer_ctxxbc07oh5ke5w1hk20")
}

<?php

require_once dirname(__DIR__) . '/vendor/autoload.php';

use Increase\Client;
use Increase\Core\Exceptions\APIException;

$client = new Client(apiKey: getenv('INCREASE_API_KEY'));

try {
  $inboundFednowTransfer = $client->inboundFednowTransfers->retrieve(
    'inbound_fednow_transfer_ctxxbc07oh5ke5w1hk20'
  );

  var_dump($inboundFednowTransfer);
} catch (APIException $e) {
  echo $e->getMessage();
}

using System;
using Increase.Api;
using Increase.Api.Models.InboundFednowTransfers;

IncreaseClient client = new();

InboundFednowTransferRetrieveParams parameters = new()
{
    InboundFednowTransferID = "inbound_fednow_transfer_ctxxbc07oh5ke5w1hk20"
};

var inboundFednowTransfer = await client.InboundFednowTransfers.Retrieve(parameters);

Console.WriteLine(inboundFednowTransfer);

Parameters

inbound_fednow_transfer_id

string

Required

The identifier of the Inbound FedNow Transfer to get details for.

More about Inbound FedNow Transfers.

Sandbox: Create an Inbound FedNow Transfer

Simulates an Inbound FedNow Transfer to your account.

curl -X "POST" \
  --url "${INCREASE_URL}/simulations/inbound_fednow_transfers" \
  -H "Authorization: Bearer ${INCREASE_API_KEY}" \
  -H "Content-Type: application/json" \
  -d $'{
    "account_number_id": "account_number_v18nkfqm6afpsrvy82b2",
    "amount": 1000
  }'

import Increase from 'increase';

const client = new Increase({
  apiKey: process.env['INCREASE_API_KEY'], // This is the default and can be omitted
});

const inboundFednowTransfer = await client.simulations.inboundFednowTransfers.create({
  account_number_id: 'account_number_v18nkfqm6afpsrvy82b2',
  amount: 1000,
});

console.log(inboundFednowTransfer.id);

import os
from increase import Increase

client = Increase(
    api_key=os.environ.get("INCREASE_API_KEY"),  # This is the default and can be omitted
)
inbound_fednow_transfer = client.simulations.inbound_fednow_transfers.create(
    account_number_id="account_number_v18nkfqm6afpsrvy82b2",
    amount=1000,
)
print(inbound_fednow_transfer.id)

require "increase"

increase = Increase::Client.new(
  api_key: ENV["INCREASE_API_KEY"] # This is the default and can be omitted
)

inbound_fednow_transfer = increase.simulations.inbound_fednow_transfers.create(
  account_number_id: "account_number_v18nkfqm6afpsrvy82b2",
  amount: 1000
)

puts(inbound_fednow_transfer)

package main

import (
	"context"
	"fmt"
	"os"

	"github.com/Increase/increase-go"
	"github.com/Increase/increase-go/option"
)

func main() {
	client := increase.NewClient(
		option.WithAPIKey(os.Getenv("INCREASE_API_KEY")), // This is the default and can be omitted
	)
	inboundFednowTransfer, err := client.Simulations.InboundFednowTransfers.New(context.TODO(), increase.SimulationInboundFednowTransferNewParams{
		AccountNumberID: increase.F("account_number_v18nkfqm6afpsrvy82b2"),
		Amount:          increase.F(int64(1000)),
	})
	if err != nil {
		panic(err.Error())
	}
	fmt.Printf("%+v\n", inboundFednowTransfer.ID)
}

package com.increase.api.example;

import com.increase.api.client.IncreaseClient;
import com.increase.api.client.okhttp.IncreaseOkHttpClient;
import com.increase.api.models.inboundfednowtransfers.InboundFednowTransfer;
import com.increase.api.models.simulations.inboundfednowtransfers.InboundFednowTransferCreateParams;

public final class Main {
    private Main() {}

    public static void main(String[] args) {
        IncreaseClient client = IncreaseOkHttpClient.fromEnv();

        InboundFednowTransferCreateParams params = InboundFednowTransferCreateParams.builder()
            .accountNumberId("account_number_v18nkfqm6afpsrvy82b2")
            .amount(1000L)
            .build();
        InboundFednowTransfer inboundFednowTransfer = client.simulations().inboundFednowTransfers().create(params);
    }
}

package com.increase.api.example

import com.increase.api.client.IncreaseClient
import com.increase.api.client.okhttp.IncreaseOkHttpClient
import com.increase.api.models.inboundfednowtransfers.InboundFednowTransfer
import com.increase.api.models.simulations.inboundfednowtransfers.InboundFednowTransferCreateParams

fun main() {
    val client: IncreaseClient = IncreaseOkHttpClient.fromEnv()

    val params: InboundFednowTransferCreateParams = InboundFednowTransferCreateParams.builder()
        .accountNumberId("account_number_v18nkfqm6afpsrvy82b2")
        .amount(1000L)
        .build()
    val inboundFednowTransfer: InboundFednowTransfer = client.simulations().inboundFednowTransfers().create(params)
}

<?php

require_once dirname(__DIR__) . '/vendor/autoload.php';

use Increase\Client;
use Increase\Core\Exceptions\APIException;

$client = new Client(apiKey: getenv('INCREASE_API_KEY'));

try {
  $inboundFednowTransfer = $client->simulations->inboundFednowTransfers->create(
    accountNumberID: 'account_number_v18nkfqm6afpsrvy82b2',
    amount: 1000,
    debtorAccountNumber: 'x',
    debtorName: 'x',
    debtorRoutingNumber: 'xxxxxxxxx',
    unstructuredRemittanceInformation: 'x',
  );

  var_dump($inboundFednowTransfer);
} catch (APIException $e) {
  echo $e->getMessage();
}

using System;
using Increase.Api;
using Increase.Api.Models.Simulations.InboundFednowTransfers;

IncreaseClient client = new();

InboundFednowTransferCreateParams parameters = new()
{
    AccountNumberID = "account_number_v18nkfqm6afpsrvy82b2",
    Amount = 1000,
};

var inboundFednowTransfer = await client.Simulations.InboundFednowTransfers.Create(parameters);

Console.WriteLine(inboundFednowTransfer);

Parameters

account_number_id

string

Required

The identifier of the Account Number the inbound FedNow Transfer is for.

More about Account Numbers.

amount

integer

Required

The transfer amount in USD cents. Must be positive.

debtor_account_number

string

The account number of the account that sent the transfer.

Between 1 and 200 characters

debtor_name

string

The name provided by the sender of the transfer.

Between 1 and 200 characters

debtor_routing_number

string

The routing number of the account that sent the transfer.

Exactly 9 characters

unstructured_remittance_information

string

Additional information included with the transfer.

Between 1 and 200 characters