ACH verification

Request

Successful account verification outcome.

Security

BasicAuth

Acceptstringrequired

Example:application/vnd.worldpay.achVerifications-v6+json

Content-Typestringrequired

Example:application/vnd.worldpay.achVerifications-v6+json

Bodyapplication/vnd.worldpay.achVerifications-v6+json

merchantobjectrequired

paymentInstrumentobjectrequired

transactionReferencestring, [ 1 .. 25 ] charactersrequired

A unique reference generated by you that is used to identify a payment throughout its lifecycle.

Example:"Memory265-13/08/1876"

{
  "merchant": {
    "entity": "default"
  },
  "transactionReference": "Memory265-13/08/1876",
  "paymentInstrument": {
    "type": "bankAccountUS",
    "accountType": "corporateSavings",
    "accountNumber": "1234567890",
    "routingNumber": "011400495",
    "companyName": "companyName",
    "billToAddress": {
      "firstName": "John",
      "lastName": "Smith",
      "address1": "address1",
      "address2": "address2",
      "address3": "address3",
      "city": "city",
      "region": "state",
      "postalCode": "postalCode",
      "countryCode": "US",
      "telephoneNumber": "4085551212"
    }
  }
}

Responses

The account verification has been successful.

Bodyapplication/vnd.worldpay.achVerifications-v6+json

outcomestringrequired

This field indicates the status of the transaction.

Enum:"verified""not verified"

descriptionstring

checkedAtstring^(\d{4})-(\d{2})-(\d{2})T(\d{2}):(\d{2}):(\d{...required

Example:"2024-03-26T19:38:29.543195Z"

Response

{
  "outcome": "verified",
  "checkedAt": "2021-09-27T18:02:16.475Z"
}