Risk

Get Money Movement Fraud

Use the Get Money Movement Fraud endpoint to evaluate the risk associated with specific money-movement transactions and account linking to understand if a customer transaction is fraudulent, then take appropriate action based on predefined criteria. This endpoint provides detailed fraud detection insights, including rules triggered, actions taken, and supplementary fraud prevention decisions.

post/prp/1.0/getMoneyMovementFraud

Request

  • Base URL
    risk-{corename}.{env}.gpsrv.com/ (relative, and the document’s source URL is not known)
  • URL
    risk-{corename}.{env}.gpsrv.com/prp/1.0/getMoneyMovementFraud
  • Auth
    none declared

Request body application/x-www-form-urlencoded

riskServiceIdstring required

Identifier created by the Risk Squad. A fixed value for each client Pattern: EPRP prefix followed by colon-separated identifiers Example: EPRP:505:401:8385

apiLoginstring required

Web service username, as provided by SoFi Tech Solutions. Pattern: Max 50 characters Example: "AbC123-9999"

apiTransKeystring required

Web service password, as provided by SoFi Tech Solutions. Pattern: Max 15 characters Example: "4sb62fh6w4h7w34g"

providerIdstring required

Your unique provider identifier from SoFi Tech Solutions. Pattern: Max 10-digit numeric string Example: "9999"

transactionIdstring required

Supply a globally unique ID to identify this endpoint request ("transaction"). A UUID is preferred. Pattern: Max 60 characters Example: "9845dk-39fdk3fj3-4483483478"

eventType'acct_vrfy' | 'ach' | 'wire' | 'rtp' | 'fednow' | 'aft' | 'oct' required

Event type. Pattern: acct_vrfy, ach, wire, rtp, fednow, aft, or oct Example: acct_vrfy

eventSubtype'finicity' | 'incoming_debit' | 'incoming_credit' | 'outgoing_debit' | 'outgoing_credit'

Event subtype. Pattern: finicity, incoming_debit, incoming_credit, outgoing_debit, or outgoing_credit Example: finicity

eventIdstring

Map trans_id to event_id Pattern: One or more digits Example: 2356109249

eventTsstring date-time required

Map trans_ts to event_ts Pattern: YYYY-MM-DD HH:MM:SS Example: 2025-05-26 01:00:00

partnerIdstring required

A unique partner identifier from SoFi Tech Solutions. Pattern: One or more digits Example: 505

progIdstring required

A unique program identifier from SoFi Tech Solutions. Pattern: One or more digits Example: 9009

prodIdstring required

A unique product identifier from SoFi Tech Solutions. Pattern: One or more digits Example: 1234

pmtRefNostring required

<a href="doc:about-accounts#prn" target="_blank">Payment reference number</a> Pattern: 12 digits Example: 999101012345

xidstring

Transaction XID Pattern: One or more digits Example: 1234

balIdstring required

Balance ID or galileo_account_number Pattern: One or more digits Example: 4321

appDatestring date-time

Timestamp for when this application was submitted Pattern: YYYY-MM-DD HH:MM:SS Example: 2025-04-18 00:00:00

instantVerifyboolean required

Whether to run <glossary:GIVE>. Pattern: true or false Example: TRUE

counterpartyPanCardNostring

Counterparty <glossary:PAN> for <glossary:AFT> or <glossary:OCT> use cases Pattern: 16 digits Example: 1234567890123456

counterpartyAcctNostring

Counterparty account number Pattern: 5–17 digits Example: 841523654

counterpartyAcctTypestring

Counterparty account type Pattern: personal, business, or other Example: personal

counterpartyAcctSubtypestring

Counterparty account subtype Pattern: checking or savings Example: checking

counterpartyRtNostring

Counterparty bank routing number Pattern: 9 digits Example: 021000021

counterpartyBalAmountnumber

Latest available balance of the counterparty account Pattern: Integer or decimal number Example: 250.15

counterpartyBalanceTsstring date-time

Timestamp for when counterpartyBalAmount was captured Pattern: YYYY-MM-DD HH:MM:SS Example: 2025-04-18 7:39:30

counterpartyIdDocTypestring

Counterparty account holder ID type: ssn, itin or ein Pattern: ssn, itin, or ein Example: ssn

counterpartyIdDocNostring

Counterparty account holder SSN or tax ID Pattern: 9 digits Example: 123456789

counterpartyFirstNamestring

Counterparty account holder first name Pattern: Letter followed by letters, spaces, apostrophes, periods, or hyphens Example: John

counterpartyMiddleNamestring

Counterparty account holder middle name Pattern: Letter followed by letters, spaces, apostrophes, periods, or hyphens Example: James

counterpartyLastNamestring

Counterparty account holder last name Pattern: Letter followed by letters, spaces, apostrophes, periods, or hyphens Example: Doe

counterpartyBusinessNamestring

Counterparty bank business name when counterpartyAcctType: business. Pattern: Non-empty text Example: John Inc

counterpartyDobstring

Counterparty account holder date of birth Pattern: One or more digits Example: 29221

counterpartyAddr1string

Counterparty account holder address line 1 Pattern: 1–60 characters Example: 1417 N Rue St.

counterpartyAddr2string

Counterparty account holder address line 2 Pattern: 1–60 characters Example: APT 5520

counterpartyCitystring

City of the counterparty account holder Pattern: Non-empty text Example: Saint Charles

counterpartyStatestring

State of the counterparty account holder Pattern: 2 uppercase letters Example: MO

counterpartyZipstring

ZIP or postal code of the counterparty account holder Pattern: 5–20 characters Example: 63301

counterpartyCtryCdstring

Two-letter country code of the counterparty account holder Pattern: 2 uppercase letters (ISO 3166-1) Example: US

counterpartyBillingAddr1string

Counterparty account holder billing address line 1 Pattern: 1–60 characters Example: 1417 n. rue st.

counterpartyBillingAddr2string

Counterparty account holder billing address line 2 Pattern: 1–60 characters Example: APT 5520

counterpartyBillingCitystring

Billing city of the counterparty account holder Pattern: Non-empty text Example: saint charles

counterpartyBillingStatestring

Billing state of the counterparty account holder Pattern: 2 uppercase letters Example: MO

counterpartyBillingZipstring

Billing ZIP or postal code of the counterparty account holder Pattern: 5–20 characters Example: 63301

counterpartyBillingCtryCdstring

Two-letter billing country code of the counterparty account holder Pattern: 2 uppercase letters (ISO 3166-1) Example: US

counterpartyMobilePhoneNostring

Counterparty account holder mobile phone number Pattern: E.164 US format: +1 followed by 10 digits Example: +11234567890

counterpartyHomePhoneNostring

Counterparty account holder home phone number Pattern: E.164 US format: +1 followed by 10 digits Example: +11234567890

counterpartyEmailAddrstring

Counterparty account holder email address Pattern: Email address Example: jdoe@example.com

counterpartyIpAddrstring

Counterparty account holder IP address Pattern: IPv4 address (four dot-separated number groups) Example: 172.16.10.20

counterpartyNameMatchScorenumber

Counterparty name match score from Finicity Pattern: 0–1 decimal Example: 0.9

counterpartyPhoneMatchIndboolean

Counterparty phone number match indicator from Finicity Pattern: true or false Example: False

counterpartyZipMatchIndboolean

Counterparty ZIP code match indicator from Finicity Pattern: true or false Example: True

counterpartyEmailMatchIndboolean

Counterparty email address match indicator from Finicity Pattern: true or false Example: True

customerPanCardNostring

Customer PAN for AFT or OCT use cases Pattern: 16 digits Example: 1234567890123456

customerAcctNostring

Customer account number (<glossary:PRN>) Pattern: 5–17 digits Example: 999101523654

customerAcctTypestring

Customer account type Pattern: personal, business, or other Example: personal

customerAcctSubtypestring

Customer account subtype Pattern: checking or savings Example: checking

customerRtNostring

Customer bank routing number Pattern: 9 digits Example: 210000221

customerBalAmountnumber

Latest available balance of the customer account Pattern: Integer or decimal number Example: 250.15

customerBalanceTsstring date-time

Timestamp for when customerBalAmount was captured. Pattern: YYYY-MM-DD HH:MM:SS Example: 2025-04-18 7:39:30

customerIdDocTypestring

Customer account holder ID type Pattern: ssn, itin, or ein Example: ssn

customerIdDocNostring

Customer account holder SSN or tax ID Pattern: 9 digits Example: 123456789

customerFirstNamestring

Customer account holder first name Pattern: Letter followed by letters, spaces, apostrophes, periods, or hyphens Example: John

customerMiddleNamestring

Customer account holder middle name Pattern: Letter followed by letters, spaces, apostrophes, periods, or hyphens Example: Arnold

customerLastNamestring

Customer account holder last name Pattern: Letter followed by letters, spaces, apostrophes, periods, or hyphens Example: Doe

customerBusinessNamestring

Customer bank business name when customerAcctType: business Pattern: Non-empty text Example: John Inc

customerDobstring

Customer account holder date of birth Pattern: One or more digits Example: 29221

customerAddr1string

Customer account holder address line 1 Pattern: 1–60 characters Example: 1417 N Rue St.

customerAddr2string

Customer account holder address line 2 Pattern: 1–60 characters Example: APT 5520

customerCitystring

City of the customer account holder Pattern: Non-empty text Example: Saint Charles

customerStatestring

State of the customer account holder Pattern: 2 uppercase letters Example: MO

customerZipstring

ZIP or postal code of the customer account holder Pattern: 5–20 characters Example: 63301

customerCtryCdstring

Two-letter country code of the customer account holder Pattern: 2 uppercase letters (ISO 3166-1) Example: US

customerBillingAddr1string

Customer billing address line 1 (AFT/OCT use cases) Pattern: 1–60 characters Example: 1417 n. rue st.

customerBillingAddr2string

Customer billing address line 2 (AFT/OCT use cases) Pattern: 1–60 characters Example: APT 5520

customerBillingCitystring

Customer billing city (AFT/OCT use cases) Pattern: Non-empty text Example: saint charles

customerBillingStatestring

Customer billing state (AFT/OCT use cases) Pattern: 2 uppercase letters Example: MO

customerBillingZipstring

Customer billing ZIP (AFT/OCT use cases) Pattern: 5–20 characters Example: 63301

customerBillingCtryCdstring

Two-letter billing country code of the customer (AFT/OCT use cases) Pattern: 2 uppercase letters (ISO 3166-1) Example: US

customerMobilePhoneNostring

Customer account holder mobile phone number Pattern: E.164 US format: +1 followed by 10 digits Example: +11234567890

customerHomePhoneNostring

Customer account holder home phone number Pattern: E.164 US format: +1 followed by 10 digits Example: +11234567890

customerEmailAddrstring

Customer account holder email address Pattern: Email address Example: jdoe@example.com

customerIpAddrstring

Customer IP address Pattern: IPv4 address (four dot-separated number groups) Example: 192.168.10.20

sequenceNumberinteger

Sequence number Pattern: Integer, optional leading minus sign Example: 20250500000000000000000000000000000

requestTsstring date-time

Map in_ts to request_ts Pattern: YYYY-MM-DD HH:MM:SS Example: 2025-05-27 13:46:37

procTsstring date-time

Processing timestamp Pattern: YYYY-MM-DD HH:MM:SS Example: 2025-05-27 13:46:45

effectiveDtstring date-time

Effective date Pattern: YYYY-MM-DD HH:MM:SS Example: 2025-05-28 00:00:00

origRecstring

Original record Pattern: Non-empty text Example: ST

batchHdrstring

Batch header Pattern: Non-empty text Example: 5200Wyndham 134233889 WEBP2P 250528250528 1096001010000003

transAmtnumber

Transaction amount (map amt to trans_amt) Pattern: Integer or decimal number Example: 300.14

currCdstring

3-letter currency code Pattern: 3 uppercase letters (ISO 4217) Example: USD

transCodestring

Transaction code Pattern: One or more digits Example: 37

transTypestring

Transaction type Pattern: Non-empty text Example: AC

statusstring

Status Pattern: Non-empty text Example: P

statusDescstring

Status description Pattern: Non-empty text Example: Processed

feeFlagstring

Fee flag Pattern: Any text, including empty Example: true

feeAmtnumber

Fee amount Pattern: Integer or decimal number Example: 1.50

loadTypestring

Load type Pattern: Non-empty text Example: M

origTracestring

Original trace Pattern: One or more digits Example: 96001015089930

retCodeDishonstring

Return code dishonor Pattern: Any text, including empty

chgCodestring

Change code Pattern: Any text, including empty

chgTsstring date-time

Change timestamp Pattern: YYYY-MM-DD HH:MM:SS, or empty

destIdstring

Destination ID Pattern: One or more digits Example: 531

destInstNamestring

Destination institution name Pattern: Non-empty text Example: Sunrise_Bank_Wyndham_AC

destInstIdstring

Destination institution ID Pattern: 9 digits Example: 271081528

destAcctTypestring

Destination account type Pattern: Non-empty text Example: S

destFilenamestring

Destination filename Pattern: Non-empty text Example: ACHs250527A531

sourceIdstring

Source ID Pattern: One or more digits Example: 531

sourceInstNamestring

Source institution name Pattern: Non-empty text Example: galileo:wyndham

sourceInstCatstring

Source institution category Pattern: Non-empty text Example: OTH

sourceInstIdstring

Source institution ID Pattern: One or more digits Example: 96001013

sourceTracestring

Source trace Pattern: One or more digits Example: 21000025074388

sourceFilenamestring

Source filename Pattern: Non-empty text Example: wyndham

destRetFilenamestring

Destination return filename Pattern: Any text, including empty

destRetTsstring date-time

Destination return timestamp Pattern: YYYY-MM-DD HH:MM:SS Example: 2025-03-07 10:20:28

destRetTracestring

Destination return trace Pattern: Any text, including empty

returnCodestring

Return code (required for certain eventSubtypes) Pattern: R followed by 2 digits Example: R01

returnTsstring date-time

Return timestamp (required for certain eventSubtypes) Pattern: YYYY-MM-DD HH:MM:SS Example: 2025-05-29 07:24:36

sourceRetFilenamestring

Source return filename Pattern: Non-empty text Example: ACH.366.250411.A

sourceRetTsstring date-time

Source return timestamp Pattern: YYYY-MM-DD HH:MM:SS Example: 2025-04-11 11:45:50

sourceRetTracestring

Source return trace Pattern: One or more digits Example: 103113352137688

origRetTracestring

Original return trace Pattern: One or more digits Example: 125109013780198

retStlDatestring date-time

Return settlement date Pattern: YYYY-MM-DD HH:MM:SS Example: 2025-01-17 00:00:00

origRetCodestring

Original return code Pattern: One or more digits Example: 01

addNostring

Additional number Pattern: One or more digits Example: 0

disbTypestring

Disbursement type Pattern: One or more digits Example: 0

retryCountinteger

Retry count Pattern: Integer, optional leading minus sign Example: -1

retryTsstring date-time

Retry timestamp Pattern: YYYY-MM-DD HH:MM:SS Example: 2025-02-19 00:22:13

batchCatstring

Batch category Pattern: One or more digits Example: 9009

revIdstring

Revision ID Pattern: Any text, including empty

sameDaystring

Same-day indicator Pattern: Y or N Example: N

origNamestring

Original name Pattern: Non-empty text Example: HEALTH CARE SERV

govOrigstring

Government origin indicator Pattern: Y or N Example: Y

reviewFlagstring

Review flag Pattern: Y or N Example: Y

reviewReasonstring

Review reason Pattern: Non-empty text Example: potential R17 return

blocksIdUsedstring

Blocks ID used Pattern: One or more digits Example: 0

identNumberstring

Identification number Pattern: One or more digits Example: 692101336968

lastEnqueuedTsstring date-time

Last-enqueued timestamp Pattern: YYYY-MM-DD HH:MM:SS Example: 2025-06-02 03:28:33

rowInsertOriginstring

Row insert origin Pattern: Non-empty text Example: aue1

rowUpdateOriginstring

Row update origin Pattern: Non-empty text Example: aue1

dscrstring

Description Pattern: Non-empty text Example: Bill Payment - Check

secCodestring

<glossary:SEC> code Pattern: 3 uppercase letters Example: WEB

companyNamestring

Company name Pattern: Non-empty text Example: Nuttige LLC

ofacStatusstring

<glossary:OFAC> status Pattern: Any text, including empty

Example request

{
  "riskServiceId": "EPRP:505:401:8385",
  "apiLogin": "\"AbC123-9999\"",
  "apiTransKey": "\"4sb62fh6w4h7w34g\"",
  "providerId": "\"9999\"",
  "transactionId": "\"9845dk-39fdk3fj3-4483483478\"",
  "eventType": "acct_vrfy",
  "eventSubtype": "finicity",
  "eventId": "2356109249",
  "eventTs": "2025-05-26 01:00:00",
  "partnerId": "505",
  "progId": "9009",
  "prodId": "1234",
  "pmtRefNo": "999101012345",
  "xid": "1234",
  "balId": "4321",
  "appDate": "2025-04-18 00:00:00",
  "counterpartyPanCardNo": "1234567890123456",
  "counterpartyAcctNo": "841523654",
  "counterpartyAcctType": "personal",
  "counterpartyAcctSubtype": "checking",
  "counterpartyRtNo": "021000021",
  "counterpartyBalanceTs": "2025-04-18 7:39:30",
  "counterpartyIdDocType": "ssn",
  "counterpartyIdDocNo": "123456789",
  "counterpartyFirstName": "John",
  "counterpartyMiddleName": "James",
  "counterpartyLastName": "Doe",
  "counterpartyBusinessName": "John Inc",
  "counterpartyDob": "29221",
  "counterpartyAddr1": "1417 N Rue St.",
  "counterpartyAddr2": "APT 5520",
  "counterpartyCity": "Saint Charles",
  "counterpartyState": "MO",
  "counterpartyZip": "63301",
  "counterpartyCtryCd": "US",
  "counterpartyBillingAddr1": "1417 n. rue st.",
  "counterpartyBillingAddr2": "APT 5520",
  "counterpartyBillingCity": "saint charles",
  "counterpartyBillingState": "MO",
  "counterpartyBillingZip": "63301",
  "counterpartyBillingCtryCd": "US",
  "counterpartyMobilePhoneNo": "+11234567890",
  "counterpartyHomePhoneNo": "+11234567890",
  "counterpartyEmailAddr": "jdoe@example.com",
  "counterpartyIpAddr": "172.16.10.20",
  "customerPanCardNo": "1234567890123456",
  "customerAcctNo": "999101523654",
  "customerAcctType": "personal",
  "customerAcctSubtype": "checking",
  "customerRtNo": "210000221",
  "customerBalanceTs": "2025-04-18 7:39:30",
  "customerIdDocType": "ssn",
  "customerIdDocNo": "123456789",
  "customerFirstName": "John",
  "customerMiddleName": "Arnold",
  "customerLastName": "Doe",
  "customerBusinessName": "John Inc",
  "customerDob": "29221",
  "customerAddr1": "1417 N Rue St.",
  "customerAddr2": "APT 5520",
  "customerCity": "Saint Charles",
  "customerState": "MO",
  "customerZip": "63301",
  "customerCtryCd": "US",
  "customerBillingAddr1": "1417 n. rue st.",
  "customerBillingAddr2": "APT 5520",
  "customerBillingCity": "saint charles",
  "customerBillingState": "MO",
  "customerBillingZip": "63301",
  "customerBillingCtryCd": "US",
  "customerMobilePhoneNo": "+11234567890",
  "customerHomePhoneNo": "+11234567890",
  "customerEmailAddr": "jdoe@example.com",
  "customerIpAddr": "192.168.10.20",
  "requestTs": "2025-05-27 13:46:37",
  "procTs": "2025-05-27 13:46:45",
  "effectiveDt": "2025-05-28 00:00:00",
  "origRec": "ST",
  "batchHdr": "5200Wyndham 134233889 WEBP2P 250528250528 1096001010000003",
  "currCd": "USD",
  "transCode": "37",
  "transType": "AC",
  "status": "P",
  "statusDesc": "Processed",
  "feeFlag": "true",
  "loadType": "M",
  "origTrace": "96001015089930",
  "destId": "531",
  "destInstName": "Sunrise_Bank_Wyndham_AC",
  "destInstId": "271081528",
  "destAcctType": "S",
  "destFilename": "ACHs250527A531",
  "sourceId": "531",
  "sourceInstName": "galileo:wyndham",
  "sourceInstCat": "OTH",
  "sourceInstId": "96001013",
  "sourceTrace": "21000025074388",
  "sourceFilename": "wyndham",
  "destRetTs": "2025-03-07 10:20:28",
  "returnCode": "R01",
  "returnTs": "2025-05-29 07:24:36",
  "sourceRetFilename": "ACH.366.250411.A",
  "sourceRetTs": "2025-04-11 11:45:50",
  "sourceRetTrace": "103113352137688",
  "origRetTrace": "125109013780198",
  "retStlDate": "2025-01-17 00:00:00",
  "origRetCode": "01",
  "addNo": "0",
  "disbType": "0",
  "retryTs": "2025-02-19 00:22:13",
  "batchCat": "9009",
  "sameDay": "N",
  "origName": "HEALTH CARE SERV",
  "govOrig": "Y",
  "reviewFlag": "Y",
  "reviewReason": "potential R17 return",
  "blocksIdUsed": "0",
  "identNumber": "692101336968",
  "lastEnqueuedTs": "2025-06-02 03:28:33",
  "rowInsertOrigin": "aue1",
  "rowUpdateOrigin": "aue1",
  "dscr": "Bill Payment - Check",
  "secCode": "WEB",
  "companyName": "Nuttige LLC"
}

Response

status_codeinteger required

The response status code. May return a string for some statuses.

statusstring required

The condition of a process or response

errorsstring[]

A list of errors generated while the request was processed

rtokenstring nullable

A system-generated ID used for tracking

processing_timenumber nullable

The time elapsed in processing the request

system_timestampstring date-time nullable

A system generated timestamp

Changes

No recorded changes to this operation across all 1 revision of this API.