List processing account's funding accounts

Browse API reference

GET/processing-accounts/{processingAccountId}/funding-accountslistProcessingAccountsFundingAccounts

Use this method to return a list of funding accounts linked to a processing acccount.

To retrieve a list of funding accounts for a processing account, you need the processingAccountId. Our gateway returned the processingAccountId in the response of the Create Merchant Platform method or the Create Proccessing Account method.

Our gateway returns information about the following for each funding account in the list:

Account information, including the name on the account and payment methods.
Status, including whether we have approved or rejected the account.

For each funding account, we also return its fundingAccountId, which you can use to perform follow-on actions.

Parameters

Name	In	Type	Description
`processingAccountId`Required	path	`string`	Unique identifier that we assigned to the processing account.

Responses

Successful request. Returns a list of funding accounts associated with the processing account.

200 OK · application/json

[
  {
    "createdDate": "2024-07-02T12:00:00.000+00:00",
    "fundingAccountId": 123,
    "lastModifiedDate": "2024-07-02T12:00:00.000+00:00",
    "links": [
      {
        "href": "https://api.payroc.com/v1/processing-accounts/38765",
        "method": "get",
        "rel": "parent"
      }
    ],
    "metadata": {
      "yourCustomField": "abc123"
    },
    "nameOnAccount": "Jane Doe",
    "paymentMethods": [
      {
        "type": "ach",
        "value": {
          "accountNumber": "******7890",
          "routingNumber": "*****6789"
        }
      }
    ],
    "status": "approved",
    "type": "checking",
    "use": "creditAndDebit"
  },
  {
    "createdDate": "2024-07-02T12:00:00.000+00:00",
    "fundingAccountId": 124,
    "lastModifiedDate": "2024-07-02T12:00:00.000+00:00",
    "links": [
      {
        "href": "https://api.payroc.com/v1/processing-accounts/38765",
        "method": "get",
        "rel": "parent"
      }
    ],
    "metadata": {
      "yourCustomField": "abc123"
    },
    "nameOnAccount": "Jane Doe",
    "paymentMethods": [
      {
        "type": "ach",
        "value": {
          "accountNumber": "******3491",
          "routingNumber": "*****8725"
        }
      }
    ],
    "status": "pending",
    "type": "checking",
    "use": "creditAndDebit"
  }
]

Response schema · 16 of 18 fields

createdDatestringdate-time
Date and time that we received your request to create the funding account in our system.
fundingAccountIdinteger
Unique identifier that we assigned to the funding account.
lastModifiedDatestringdate-time
Date and time that the funding account was last modified.
linksobject[]
Array of HATEOAS links.
- hrefstringrequired
  URL of the target resource.
- methodstringrequired
  HTTP method that you need to use with the target resource.
- relstringrequired
  Indicates the relationship between the current resource and the target resource.
metadataobject
Metadata object you can use to include custom data with your request.
nameOnAccountstringrequired
Name of the account holder.
paymentMethodsobject[]required
Array of PaymentMethodAch objects.
- ACH payment methodobject
  - typestring
    Payment method that we use to send funds to the account.ach
  - valueobject
    Object that contains information about the funding account.+2 more fields at deeper levels — see the full spec
statusstring
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.approvedrejectedpendinghold
typestringrequired
Type of funding account.checkingsavingsgeneralLedger
usestringrequired
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.creditdebitcreditAndDebit

Invalid request

400 Bad Request · application/problem+json

{
  "detail": "One or more validation errors occurred, see error section for more info",
  "errors": [
    {
      "detail": "invalid date",
      "message": "Expected time, got '' for start_time",
      "parameter": "start_time"
    }
  ],
  "status": 400,
  "title": "Bad request",
  "type": "https://docs.payroc.com/api/errors#bad-request"
}

Response schema · 8 fields

detailstringrequired
Explanation of the problem
errorsobject[]
- detailstring
  Short detail of the validation errors
- messagestring
  Error message
- parameterstring
  The parameter or field causing the issues
statusintegerrequired
Http status code
titlestringrequired
Short description of the issue.
typestringrequired
URI reference identifying the problem type

Identity could not be verified

401 Unauthorized · application/problem+json

{
  "detail": "Your identity could not be verified",
  "status": 401,
  "title": "Not Authorized",
  "type": "https://docs.payroc.com/api/errors#not-authorized"
}

Response schema · 4 fields

detailstringrequired
Explanation of the problem
statusintegerrequired
Http status code
titlestringrequired
Short description of the issue.
typestringrequired
URI reference identifying the problem type

Identity could not be verified

403 Forbidden · application/problem+json

{
  "detail": "Your identity could not be verified",
  "status": 401,
  "title": "Not Authorized",
  "type": "https://docs.payroc.com/api/errors#not-authorized"
}

Response schema · 4 fields

detailstringrequired
Explanation of the problem
statusintegerrequired
Http status code
titlestringrequired
Short description of the issue.
typestringrequired
URI reference identifying the problem type

Resource not found

404 Not Found · application/problem+json

{
  "detail": "Resource not found",
  "resource": "(The Type of the Resource)",
  "status": 404,
  "title": "Not found",
  "type": "https://docs.payroc.com/api/errors#not-found"
}

Response schema · 5 fields

detailstringrequired
Explanation of the problem
resourcestring
Resource that was not found
statusintegerrequired
Http status code
titlestringrequired
Short description of the issue.
typestringrequired
URI reference identifying the problem type

Not acceptable

406 Not Acceptable · application/problem+json

{
  "detail": "Resource does not support the representation requested",
  "status": 406,
  "title": "Not acceptable",
  "type": "https://docs.payroc.com/api/errors#not-acceptable"
}

Response schema · 4 fields

detailstringrequired
Explanation of the problem
statusintegerrequired
Http status code
titlestringrequired
Short description of the issue.
typestringrequired
URI reference identifying the problem type

An error has occured

500 Internal Server Error · application/problem+json

{
  "detail": "We are unable to process your request at this time",
  "errors": [
    {
      "message": "Service offline"
    }
  ],
  "status": 500,
  "title": "Api error",
  "type": "https://docs.payroc.com/api/errors#api-error"
}

Response schema · 6 fields

detailstringrequired
Explanation of the problem
errorsobject[]
- messagestring
  Error message
statusintegerrequired
Http status code
titlestringrequired
Short description of the issue.
typestringrequired
URI reference identifying the problem type

Used in workflows

review-merchant-hierarchy

List processing account's funding accounts

Browse API reference

Parameters

Responses

Used in workflows

Menu

Sign out

Talk to an engineer