Skip to main content
POST
/
v2
/
payments
/
ach
/
pull
Originate an ACH Pull
curl --request POST \
  --url https://api.sandbox.solidfi.com/v2/payments/ach/pull \
  --header 'Content-Type: application/json' \
  --header 'api-key: <api-key>' \
  --data '{
  "sub_account_id": "sub_bda1e562657c41e553104b10aad3fe70",
  "counterparty_id": "ctp_8e5541c8a9e50c3af3b0daacf9175130",
  "amount": "500.00",
  "description": "May Rent",
  "same_day": "true",
  "effective_date": "2024-04-05",
  "company_entry_description": "Payment",
  "external_reference_id": "123-9088-2"
}'
{
  "id": "txn_817d2a074042bb4ec54e08fd82b1e0a8",
  "client_id": "cli_64c6c87ee9d609f36a6f390dc378a4ce",
  "master_account_holder_id": "mah_201e02c581a098a740456c5c19fcfcd6",
  "master_account_id": "mas_743fa071316bc6beaf5dddfd05f49c30",
  "sub_account_holder_id": "sah_5ccfeef0adf0cbe2aa0980d2c9505752",
  "sub_account_id": "sub_bda1e562657c41e553104b10aad3fe70",
  "status": "originated",
  "amount": "500.00",
  "currency": "usd",
  "direction": "credit",
  "method": "ach",
  "type": "pull",
  "message": "outgoing",
  "description": "May Rent",
  "available_balance": "250.00",
  "pending_credits": "500.00",
  "pending_debits": "0.00",
  "counterparty": {
    "id": "ctp_8e5541c8a9e50c3af3b0daacf9175130",
    "name": "John Doe",
    "verification_status": "pass",
    "account_number": "98324502",
    "routing_number": "121042882",
    "account_type": "business_checking",
    "bank_name": "Wells Fargo",
    "beneficiary_bank": null,
    "correspondent_bank": null,
    "shipping_address": null
  },
  "ach": {
    "same_day": "true",
    "effective_date": "2024-04-04",
    "company_discretionary_data": "DIRECT DEPOSIT",
    "company_entry_description": "Payments",
    "trace_number": "",
    "return_code": "",
    "rta_id": ""
  },
  "parent_transaction_id": "",
  "external_reference_id": "123-9088-2",
  "purpose": "",
  "ofac": {
    "status": "pass",
    "last_updated_at": "2024-04-01T21:00:00Z"
  },
  "attachments": null,
  "metadata": null,
  "reconciliation": {
    "status": "not_reconciled",
    "master_account": null,
    "sub_account": [
      {
        "id": "sub_bda1e562657c41e553104b10aad3fe70",
        "transaction_id": "txn_817d2a074042bb4ec54e08fd82b1e0a8",
        "amount": "500.00"
      }
    ]
  },
  "timestamps": {
    "created_at": "2024-04-04T11:06:00Z",
    "updated_at": "2024-04-04T11:06:00Z",
    "settled_at": "2024-04-04T11:06:00Z"
  }
}

Headers

​
api-key
string
required
Example:

Body

application/json
​
sub_account_id
string
Example:
​
counterparty_id
string
Example:
​
amount
string
Example:
​
description
string
Example:
​
same_day
string
Example:
​
effective_date
string
Example:
​
company_discretionary_data
string
Example:
​
company_entry_description
string
Example:
​
external_reference_id
string
Example:

Response

​
id
string
Example:
​
sub_account_id
string
Example:
​
master_account_id
string
Example:
​
status
enum<string>
Available options:
originated,
pending,
clearing,
cleared,
settled,
canceled,
in_review,
returned,
reversed,
received,
declined,
refunded
Example:
​
amount
string
Example:
​
currency
enum<string>
Available options:
usd
Example:
​
direction
enum<string>
Available options:
debit,
credit
Example:
​
method
enum<string>
Available options:
ach,
domestic_wire,
international_wire,
check,
fednow,
rtp,
debit_card,
card_issuing
Example:
​
type
enum<string>
Available options:
push,
pull,
decline,
cancel,
return,
send,
deposit,
request,
auth,
adjust,
reverse,
refund
Example:
​
message
enum<string>
Available options:
incoming,
outgoing
Example:
​
description
string
Example:
​
available_balance
string
Example:
​
pending_credits
string
Example:
​
pending_debits
string
Example:
​
counterparty
object
​
ach
object
​
domestic_wire
object
​
international_wire
object
​
rtp
object
​
fednow
object
​
check
object
​
card
object
​
external_reference_id
string
Example:
​
purpose
string
Example:
​
ofac
object
​
attachments
object[]
​
metadata
object
​
reconciliation
object
​
timestamps
object