Reinitiate a bank transfer

mutation ReinitiateBankTransfer($input: ReinitiateBankTransferInput!) {
  reinitiateBankTransfer(initiateBankTransferInput: $input) {
    bankTransferResponse {
      ... on BankTransferApproval {
        transactionId
        paymentId
        processorResponseCode
        timestampUtc
        isDuplicateRequest
      }
      ... on BankTransferDecline {
        message
        processorAdvice
        declineType
        timestampUtc
        transactionId
      }
    }
    errors {
      errorType: __typename
      ... on ValidationFailureError {
        message
        fieldPath
      }
      ... on RouteNotFoundError {
        message
      }
      ... on AcceptorNotFoundError {
        message
      }
    }
  }
}

{
  "input": {
    "acceptorId": "05a39b14-f29f-443b-a107-da3e3e8969fb",
    "transactionReference": "86e90e33-4270-48e2-ae6c-bb2dcc876e39",
    "paymentId": "51740c23-5719-431a-81cb-c38a0875d64f",
    "transactionId": "51740c23-5719-431a-81cb-c38a0875d64f"
  }
}

{
  "data": {
    "reinitiateBankTransfer": {
      "bankTransferResponse": {
        "transactionId": "f14f0a48-35c4-4e68-b2e3-e40f6d6160a8",
        "paymentId": "792282f2-d929-4dad-8c8a-9552c92154f1",
        "processorResponseCode": "A0000",
        "timestampUtc": "2024-02-13T10:30:00Z",
        "isDuplicateRequest": false
      }
    }
  }
}

What is it? A reinitiate bank transfer request retries a previous ACH sale that was returned.

When to Use

The original bank transfer was returned for insufficient funds (R01) or uncollected funds (R09). Acceptors are limited to two reinitiation attempts.
The original bank transfer was returned for stopped payment (R08) and the acceptor has obtained a new “authorization”/permission from their customer to reinitiate.
It is submitted within 180 days of the original bank transfer settlement date.

ScenarioBen purchased an item for $150 using his checking account at Maple Street Coffee, one of Clearpath Payment’s acceptors. Clearpath Payments submits a request to initiate a bank transfer from Ben’s bank account ending in 5678. Two days later, Ben’s bank returns the transaction with an R01 return code. Clearpath Payments retries the transaction in their next billing cycle.

Steps

Call the reinitiateBankTransfer mutation, passing in the required and optional input fields:

Required input	Description
`acceptorId`	The unique, 36 character identifier assigned to the entity providing the goods or services to the customer. Other processors may refer to this as the Merchant ID (MID), Outlet ID, or Customer number.
`paymentId`	The unique ‘paymentId’ of the bank transfer transaction that is to be reinitiated.
`transactionId`	The unique ‘transactionId’ of the specific transaction within the payment that is to be reinitiated.
`transactionReference`	The unique transaction identifier created by YOU to distinguish this transaction from another.

The response will include a new transactionId and will share the same fields as the initiateBankTransfer. The paymentId will be the same.

mutation ReinitiateBankTransfer($input: ReinitiateBankTransferInput!) {
  reinitiateBankTransfer(initiateBankTransferInput: $input) {
    bankTransferResponse {
      ... on BankTransferApproval {
        transactionId
        paymentId
        processorResponseCode
        timestampUtc
        isDuplicateRequest
      }
      ... on BankTransferDecline {
        message
        processorAdvice
        declineType
        timestampUtc
        transactionId
      }
    }
    errors {
      errorType: __typename
      ... on ValidationFailureError {
        message
        fieldPath
      }
      ... on RouteNotFoundError {
        message
      }
      ... on AcceptorNotFoundError {
        message
      }
    }
  }
}

{
  "input": {
    "acceptorId": "05a39b14-f29f-443b-a107-da3e3e8969fb",
    "transactionReference": "86e90e33-4270-48e2-ae6c-bb2dcc876e39",
    "paymentId": "51740c23-5719-431a-81cb-c38a0875d64f",
    "transactionId": "51740c23-5719-431a-81cb-c38a0875d64f"
  }
}

{
  "data": {
    "reinitiateBankTransfer": {
      "bankTransferResponse": {
        "transactionId": "f14f0a48-35c4-4e68-b2e3-e40f6d6160a8",
        "paymentId": "792282f2-d929-4dad-8c8a-9552c92154f1",
        "processorResponseCode": "A0000",
        "timestampUtc": "2024-02-13T10:30:00Z",
        "isDuplicateRequest": false
      }
    }
  }
}

Validate a bank account Convenience, service fees and surcharges

⌘I

Card transactions

Bank transfers

Managing fees

Reinitiate a bank transfer

Steps

​Steps

Steps