API Reference
Log into Sandbox

ACH Debit Webhook

post
https://client.domain.com/achdebit

Use this webhook to approve or deny incoming ACH debits. Use the response_code field in the response to communicate your decision to SoFi Tech Solutions.

Body Params

Information about the ACH debit transaction.

string
required
length between 12 and 12

Payment reference number for the account Example: "999200002022"

string
required

Account status code. See the possible values in the Account Statuses enumeration.

Example: "N"

float
required

The amount of the ACH debit. Example: 150.00

string
required
length between 3 and 3

The three-digit currency code for the amounts. ISO 4217 Numeric Currency Code. 3 digits. Example: "840"

float
required

Amount of funds available to the account holder. Example: 500.00

string
required
length ≤ 30

Name of the ACH account holder. Example: "John Doe"

string
required
length ≤ 35

Name of the ODFI that receives the debited funds. Example: "Widgets Incorporated"

string
required
length between 3 and 3

The three-character standard entry class (SEC) code. Example: "WEB"

boolean
required

Whether this is an international transaction. Example: "false"

string
required
length ≤ 10

Description from the ACH header. Example: "PAYROLL "

string
required

Timestamp when this webhook message was sent. Format is <timestamp><timezone> where timestamp is YYYYmmdd:HHMMSS and timezone is always MST. Example: "20270315:121504MST"

integer
required

The unique identifier of the ACH transaction. Also called ach_trans_id and deposit_transaction_id in the Program API. Example: 32146803

string
enum
required
length ≤ 16

The version of this API. Hard-coded to "1.0".

Allowed:
string
required
length ≤ 94

The batch header for the Nacha file that contained this ACH debit entry detail record. Example: "5225WIDGET INC DISCRETIONARY DATA 1234567890POSPAYROLL 2027052003070642123456780000001"

string
required
length ≤ 20

The source trace number from the ACH record. Example: "123456781234567"

string

The JSON web token (JWT) that authenticates the HTTP request from SoFi Tech Solutions. See the security overview for more information and an example.

Headers
uuid
required

A unique identifier for the HTTP request.

Response

Updated 2 days ago

Did this page help you?
Language
LoadingLoading…
Response
Choose an example:
application/json

Updated 2 days ago

Did this page help you?

© SoFi Technology Solutions, LLC 2026    Privacy Disclosure

All documentation, including but not limited to text, graphics, images, and any other content, are the exclusive property of SoFi Technology Solutions, LLC and are protected by copyright laws. These materials may not be reproduced, distributed, transmitted, displayed, or otherwise used without the prior written permission of SoFi Technology Solutions, LLC. Any unauthorized use or reproduction of these materials are expressly prohibited.