Bank Transfer Status Request

Overview

A bank transfer status request is used to check on the status of a previous Bank Transfer Request to tell whether the previous request has been fully paid or not.

The status request can be made either synchronously or asynchronously. Radial recommends that all webstores make this request synchronously, and that order management systems work with Radial to figure out which methodology fits best with their model. For the ansynchronous implementation, see Bank Transfer Status .

If this transaction receives any of the failure responses (REJECTED, ERROR, or TIMEOUT without retries), the standard process is to secure a new tender before shipping.

The following are the reply statuses and followup actions for each.

• PENDING: Transaction is still pending. The order can be processed at this point, if desired. Further requests can be made to check for a non-pending status.
• REJECTED: Transaction was rejected. The order should not be processed. A new tender can be sent to attempt the transaction. The webstore can present the customer with an option to use another tender.
• CONFIRMED_WITH_SECURITY_IND: Bank has confirmed payment, with a security indicator of 1. Most merchants choose to process the order; however, if a business decision is made to not ship orders with this status, a refund transaction (Payment Settlement) must be initiated.
• PAID: The transaction is complete. The order can be processed.
• TIMEOUT: Radial did not receive a valid response from the payment gateway. Radial recommends having a retry that makes an attempt once every configurable unit of time up to a configurable amount of attempts.
• ERROR: There was an error with the transaction. The order should not be processed, and the webstore can present the customer with an option to use another tender.

Note: For asynchronous requests, if Radial does not receive a valid response from the payment gateway, a configured number of retries are made to the payment gateway. The response is sent back when a final status is available or after exhausting the number of retries.

URI Summary

Request Example

<?xml version="1.0" encoding="UTF-8"?>
<BankTransferStatusCheckoutRequest requestId="000001" xmlns="http://api.gsicommerce.com/schema/checkout/1.0">
    <PaymentContext>
        <OrderId>string</OrderId>
    </PaymentContext>
    <CurrencyCode>EUR</CurrencyCode>
</BankTransferStatusCheckoutRequest>

Request Elements

Response Example

<?xml version="1.0" encoding="UTF-8"?>
<BankTransferStatusCheckoutReply xmlns="http://api.gsicommerce.com/schema/checkout/1.0">
   <PaymentContext>
      <OrderId>string</OrderId>
   </PaymentContext>
   <StoreId>TSAUS</StoreId>
   <Status>PAID</Status>
</BankTransferStatusCheckoutReply>

Response Elements