Sign in
Wires

Reject an outgoing wire pending compliance review

Declines an outgoing wire held in PENDING_COMPLIANCE_REVIEW, either as a confirmed sanctions match or for an unrelated, confirmed fraud finding, releasing the held funds. Only valid while the wire is pending compliance review.

post/wires/{wire_id}/reject

Path parameters

wire_idstring uuid required
Example:b01db9c7-78f2-4a99-8aca-1231d32f9b96

The unique identifier of a wire transfer.

Headers

Idempotency-Keystring
Example:7d943c51-e4ff-4e57-9558-08cab6b963c7

An idempotency key is an arbitrary unique value generated by client to detect subsequent retries of the same request. It is recommended that a UUID or a similar random identifier be used as an idempotency key. A different key must be used for each request, unless it is a retry.

Request body

reasonstring required

Reason the wire is being rejected, for the compliance audit trail.

Example request

{
  "decision_reason": {
    "fraud": "confirmed_fraud",
    "ofac": "true_match"
  },
  "reason": "Confirmed true match against OFAC SDN list"
}

Response

Rejected wire

amountinteger required

Transfer amount in cents ($100 would be 10000)

bank_messagestring

Instructions intended for the financial institutions that are processing the wire.

batch_idstring uuid

The batch ID associated with the wire if it was created via the batch payment API.

case_idinteger

The case id associated with the wire.

creation_timestring date-time required
currencystring required

3-character currency code

customer_idstring uuid

The customer UUID representing the person initiating the Wire transfer

effective_datestring date required

The effective date of the transaction once it gets posted

fed_input_message_accountability_datastring

The Synctera-generated IMAD can be overwritten when the wire is uploaded to the FED. If that happens and we are provided with the new IMAD, it will be populated in this field.

idstring uuid required

wire ID

input_message_accountability_datastring

The input message accountability data consists of a 8 character cycle date (CCYYMMDD) an 8 character source and a 6 character sequence number.

is_bulkboolean required

Whether or not the wire is a "bulk" wire created via the batch payment API.

last_updated_timestring date-time required
networkstring

The network used to process the wire

originating_account_idstring uuid

Sender account ID

originating_account_numberstring string required

The account number representing the sender account. If the outgoing wire is a return, it refers to the sender of the initial wire not the sender of the return.

receiving_account_idstring uuid

The external account uuid representing the recipient of the wire.

receiving_account_numberstring string required

The account number representing the recipient account. If the outgoing wire is a return, it refers to the recipient of the initial wire not the destination of the return.

recipient_messagestring

Information from the originator to the beneficiary (recipient).

sanction_screening_idstring uuid
sender_reference_idstring required

Sender's id associated with fedwire transfer

settlement_datestring date

The settlement date of the transaction once it gets posted

status'CANCELED' | 'COMPLETED' | 'DECLINED' | 'PENDING' required

The current status of the transfer

status_details'APPROVED' | 'CANCELED' | 'DECLINED_COMPLIANCE_REVIEW' | 'DECLINED_DUAL_APPROVAL' | 'DECLINED_FRAUD' | 'PENDING_COMPLIANCE_REVIEW' | 'PENDING_DUAL_APPROVAL'

Additional details about the status of the transfer

transaction_idstring uuid required

ID of the resulting transaction resource

transaction_in_idstring uuid

The transaction uuid of the incoming wire that triggered an outgoing return. This is only used if the outgoing wire is a return.

Example response

{
  "amount": 10000,
  "case_id": 53,
  "creation_time": "2010-05-06T12:23:34.321Z",
  "currency": "USD",
  "customer_id": "b01db9c7-78f2-4a99-8aca-1231d32f9b96",
  "effective_date": "2022-03-18",
  "fed_input_message_accountability_data": "10220318BANK0001123456",
  "input_message_accountability_data": "10220318BANK0001123456",
  "last_updated_time": "2010-05-06T12:23:34.321Z",
  "network": "fedwire",
  "originating_account_id": "b01db9c7-78f2-4a99-8aca-1231d32f9b96",
  "receiving_account_id": "b01db9c7-78f2-4a99-8aca-1231d32f9b96",
  "return_data": {
    "reason_code": "NARR"
  },
  "sender_reference_id": "9F564A6124E65",
  "settlement_date": "2022-03-18",
  "status": "PENDING",
  "status_details": "PENDING_DUAL_APPROVAL",
  "transaction_in_id": "b01db9c7-78f2-4a99-8aca-1231d32f9b96"
}

Changes

Changed in 5 of the 8 revisions of this API.324

  • a9a5c394da16122See the full diff
    • ▲

      the request property type changed from no type to object

      request-property-type-changed

    • ●

      removed from the request property allOf list

      request-property-all-of-removed

    • ●

      added the new DECLINED_FRAUD enum value to the response property for the response status

      response-property-enum-value-added

    • ○

      added the new optional request property /

      new-optional-request-property

    • ○

      added the new optional request property /

      new-optional-request-property

  • e2bafc65e5b01See the full diff
    • ▲

      added the new required request property

      new-required-request-property

  • cbc9aeafeb2c1See the full diff
    • ○

      endpoint added

      endpoint-added

  • a6363e3dbb7b1See the full diff
    • ▲

      api path removed without deprecation

      api-path-removed-without-deprecation

    This revision also has 3 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

  • 1df97930c9181See the full diff
    • ○

      endpoint added

      endpoint-added