PApayroc
fundingRecipients

Create funding account

Changed on

Use this method to create a funding account and add it to a funding recipient.

To add a funding account to a funding recipient, you need the recipientId. Our gateway returned the recipientId in the response of the Create Funding Recipient method.

Note: If you don't have the recipientId, use our List Funding Recipients method to search for the funding recipient.

In the request, include the following information:

  • Account type, for example, if the account is a checking or savings account.
  • Account holder's name.
  • ACH information, including the routing number and account number of the account.

Our gateway returns the fundingAccountId, which you can use to run follow-on actions.

post/funding-recipients/{recipientId}/funding-accounts

Request

  • Base URL
    https://api.payroc.com/v1
  • URL
    https://api.payroc.com/v1/funding-recipients/{recipientId}/funding-accounts
  • Auth
    HTTP bearer

Path parameters

recipientIdinteger required

Unique identifier that we assigned to the funding recipient.

Headers

Idempotency-Keystring uuid required

Unique identifier that you generate for each request. You must use the UUID v4 format for the identifier. For more information about the idempotency key, go to Idempotency.

Request body

fundingAccountIdinteger

Unique identifier that we assigned to the funding account.

createdDatestring date-time

Date and time that we received your request to create the funding account in our system.

lastModifiedDatestring date-time

Date and time that the funding account was last modified.

status'approved' | 'rejected' | 'pending' | 'hold'

Status of the funding account. The value is one of the following:

  • approved - We approved the funding account.
  • rejected - We rejected the funding account.
  • pending - We have not yet approved the funding account.
  • hold - Our Risk team have temporarily placed a hold on the funding account.
type'checking' | 'savings' | 'generalLedger' required

Type of funding account.

use'credit' | 'debit' | 'creditAndDebit' required

Indicates if we send funds or withdraw funds from the account.

  • credit - Send funds to the account.
  • debit - Withdraw funds from the account.
  • creditAndDebit - Send funds and withdraw funds from the account.

Note: If the funding account is associated with a funding recipient, we accept only a value of credit.

nameOnAccountstring required

Name of the account holder.

metadataobject

Metadata object you can use to include custom data with your request.

Response

Successful request. We created the funding account and added it to the funding recipient.

fundingAccountIdinteger

Unique identifier that we assigned to the funding account.

createdDatestring date-time

Date and time that we received your request to create the funding account in our system.

lastModifiedDatestring date-time

Date and time that the funding account was last modified.

status'approved' | 'rejected' | 'pending' | 'hold'

Status of the funding account. The value is one of the following:

  • approved - We approved the funding account.
  • rejected - We rejected the funding account.
  • pending - We have not yet approved the funding account.
  • hold - Our Risk team have temporarily placed a hold on the funding account.
type'checking' | 'savings' | 'generalLedger' required

Type of funding account.

use'credit' | 'debit' | 'creditAndDebit' required

Indicates if we send funds or withdraw funds from the account.

  • credit - Send funds to the account.
  • debit - Withdraw funds from the account.
  • creditAndDebit - Send funds and withdraw funds from the account.

Note: If the funding account is associated with a funding recipient, we accept only a value of credit.

nameOnAccountstring required

Name of the account holder.

metadataobject

Metadata object you can use to include custom data with your request.

Changes

  • 9fc1e1d5b4a8Revision changes
    • warning

      deleted the header request parameter Authorization

    • info

      the endpoint scheme security Bearer was added to the API

  • 9af893904873Revision changes
    • info

      api operation id createAccount removed and replaced with fundingRecipients_createAccount