pmt_hub_return

SoFi Tech Solutions rejected and returned an incoming transaction over Payment Hub rails. Available balance has not changed.

  • CodeRTNG
  • Event trigger — SoFi Tech Solutions returns an incoming transaction.
  • Process — This process contains the event trigger:
    • SoFi Tech Solutions receives an incoming transaction over Payment Hub rails.

Fields

All fields are strings. Your field names may vary. Default fields are included in the default webhook template. See Default and optional fields for more information.

Field Default Description
amount X

Amount of the transaction. Example: "100.23"

ch_group_id

Corporate Hierarchy group identifier. Example: "2544"

extcustid

Identifier used to associate multiple accounts under the same customer. This identifier is supplied by the provider, not SoFi Tech Solutions. Example: "acv#-@45!sbsxm%-"

msg_event_id

Unique system-generated identifier for this message. Example: "243693"

msg_id

The four-letter code to identify this event. Example: "RTNG"

odfi_routing_number

Routing number for the originating depository financial institution (ODFI) of an ACH or wire transaction. Nine digits. Example: "325491456"

orig_acct_number

ACH or wire originator account number. Example: "265493042"

orig_name

ACH, Real-Time Payment (RTP), or wire originator name. See Originator and source names for details. Example: "ABC Bank".

payment_rail X

The rails over which this transaction arrived at SoFi Tech Solutions: fedwire or ach. Example: "fedwire"

pmt_ref_no X

SoFi Tech Solutions 12-digit payment reference number (PRN) for the account. Example: "999101003022"

prod_id X

The product ID of the account. Example: "1701"

prog_id X

The program ID of the account. Example: "305"

receive_ts X

Timestamp for when SoFi Tech Solutions first recorded the transaction. YYYY-MM-DD hh:mm:ss Example: " 5-11-03 11:14:22"

return_reason X

The reason this transaction was returned. Valid values:

  • Core not found

  • PRN (beneficiary identifier) not found

  • Duplicate transaction

  • Beneficiary tag is wrong

  • Wires not enabled on account

  • AccountCanceled

  • LoadLimit

  • Account not found

source X

The filename and position of the transaction that was returned. Format: {file_name}:{position} Example: "fedwire_filename:2235"

timestamp X

Timestamp for when this event was created, in system time. Format: YYYY-MM-DD hh:mm:ss MST Example: "2025-01-31 17:20:33 MST"

trans_type X

Whether the transaction would have been a credit or debit. Example: "credit"

transaction_id X

Identifier for the transaction as provided by the sender. Example: "20250623B1Q8151C010268"

type X

The name of this event: "pmt_hub_return"

Example

# pmt_hub_return example:
{
  "amount": "100.23",
  "extcustid": "acv#-@45!sbsxm%-",
  "msg_event_id": "243693",
  "msg_id": "RTNG",
  "odfi_routing_number": "325491456",
  "orig_acct_number": "265493042",
  "orig_name": "ABC Bank",
  "payment_rail": "fedwire",
  "pmt_ref_no": "999101003022",
  "prod_id": "1701",
  "prog_id": "305",
  "receive_ts": "2025-11-03 11:14:22",
  "return_reason": "LoadLimit",
  "source": "fedwire_filename:2235",
  "timestamp": "2025-01-31 17:20:33 MST",
  "trans_type": "credit",
  "transaction_id": "20250623B1Q8151C010268",
  "type": "pmt_hub_return"
}

© 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.