Bank Transfer Status

Overview

The order management system should submit a BankTransferStatusCheckoutRequest message to determine when to ship goods. The asynchronous version of this operation returns a BankTransferStatusCheckoutReply message only when the bank transfer transaction reaches an actionable state (for example, PAID or REJECTED).

For some bank transfer tenders, the CONFIRMED_WITH_SECURITY_IND status might be returned before the PAID status. It is safe to ship once the transaction reaches CONFIRMED_WITH_SECURITY_IND, if there is a desire to ship as soon as possible.

An alternate response format, BankTransferStatusCheckoutReplyList, groups several events together in a single message, and is intended for clients using the Webhooks Implementation for Asynchronous Messages. If you are using the Webhooks implemention, see Bank Transfer Status List Event, below.

URI Summary

Request Example

The request is a BankTransferStatusCheckoutRequest message.

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

Request Elements

HTTP Response

<?xml version="1.0" encoding="UTF-8"?>
<AckReply xmlns="http://api.gsicommerce.com/schema/checkout/1.0">
   <Received/>
</AckReply>

Queue Format

q.Payments.BankTransfer.Status.<RABBIT_MQ_USERNAME>

Response Example

The response is a BankTransferStatusCheckoutReply message.

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

Response Elements

Bank Transfer Status List Event

The xml response (mentioned below) contains a list of BankTransferStatusCheckoutReply messages all clubbed under one parent element and is available only for clients using webhook. This message cannot be obtained from a queue in RabbitMQ and hence the queue format is not applicable for this message. If you want to sign up for these events please contact customer service.

However, individual BankTransferStatusCheckoutReply message continues to live on RabbitMQ server and can be accessed using the information provided above.

Response Example

The response is a list of BankTransferStatusCheckoutReply messages. Instead of returning single BankTransferStatusCheckoutReply message, a list/batch of messsages are getting returned

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

Response Elements