Internet Banking

📘
API Method
PGW SDK API Interface

🚧
References
SDK Payment Classes
SDK Payment Enums

1. Prepare Payment Token Request

To prepare a payment token request, refer to the required parameters below.

📘
Payment Token API
Refer to: Payment Token API

{
    "merchantID": "JT04",
    "invoiceNo": "1595219400",
    "description": "2 days 1 night hotel room",
    "amount": 10.0,
    "currencyCode": "THB",
    "nonceStr": "a8092512-b144-41b0-8284-568bb5e9264c",
    "paymentChannel": ["IMBANK"]
}

2. Receive Payment Token Response

To receive a payment token response, refer to the sample payment token response below.

String paymentToken = "roZG9I1hk/GYjNt+BYPYbxQtKElbZDs9M5cXuEbE+Z0QTr/yUcl1oG7t0AGoOJlBhzeyBtf5mQi1UqGbjC66E85S4m63CfV/awwNbbLbkxsvfgzn0KSv7JzH3gcs/OIL";

val paymentToken = "roZG9I1hk/GYjNt+BYPYbxQtKElbZDs9M5cXuEbE+Z0QTr/yUcl1oG7t0AGoOJlBhzeyBtf5mQi1UqGbjC66E85S4m63CfV/awwNbbLbkxsvfgzn0KSv7JzH3gcs/OIL"

NSString *paymentToken = @"roZG9I1hk/GYjNt+BYPYbxQtKElbZDs9M5cXuEbE+Z0QTr/yUcl1oG7t0AGoOJlBhzeyBtf5mQi1UqGbjC66E85S4m63CfV/awwNbbLbkxsvfgzn0KSv7JzH3gcs/OIL";

let paymentToken: String = "roZG9I1hk/GYjNt+BYPYbxQtKElbZDs9M5cXuEbE+Z0QTr/yUcl1oG7t0AGoOJlBhzeyBtf5mQi1UqGbjC66E85S4m63CfV/awwNbbLbkxsvfgzn0KSv7JzH3gcs/OIL"

String paymentToken = 'roZG9I1hk/GYjNt+BYPYbxQtKElbZDs9M5cXuEbE+Z0QTr/yUcl1oG7t0AGoOJlBhzeyBtf5mQi1UqGbjC66E85S4m63CfV/awwNbbLbkxsvfgzn0KSv7JzH3gcs/OIL';

let paymentToken = 'roZG9I1hk/GYjNt+BYPYbxQtKElbZDs9M5cXuEbE+Z0QTr/yUcl1oG7t0AGoOJlBhzeyBtf5mQi1UqGbjC66E85S4m63CfV/awwNbbLbkxsvfgzn0KSv7JzH3gcs/OIL';

3. Prepare Payment Request

To prepare a payment request, refer to the sample code below.

📘
Payment Request Parameters
Refer to: Payment Request API Parameter

🚧
Payment Channel Matrix
To see the available payment channels and agents for supported banks, refer to: Payment Channel Matrix

PaymentCode paymentCode = new PaymentCode("123", "THUOB", "IBANKING");

PaymentRequest paymentRequest = new InternetBankingBuilder(paymentCode)
                                .setName("DavidBilly")
                                .setEmail("[email protected]")
                                .setMobileNo("0888888888")
                                .build();

val paymentCode = PaymentCode("123", "THUOB", "IBANKING")
 
val paymentRequest = InternetBankingBuilder(paymentCode).apply {
       name("DavidBilly")
       email("[email protected]")
       mobileNo("0888888888")
}.build()

PaymentCode *paymentCode = [[PaymentCode alloc] initWithChannelCode: @"123" agentCode: @"THUOB" agentChannelCode: @"IBANKING"];

PaymentRequest *paymentRequest = [[[[[[InternetBankingBuilder alloc] initWithPaymentCode: paymentCode]
                                       name: @"DavidBilly"]
                                       email: @"[email protected]"]
                                       mobileNo: @"0888888888"]
                                       build];

let paymentCode: PaymentCode = PaymentCode(channelCode: "123", "THUOB", "IBANKING")

let paymentRequest: PaymentRequest = InternetBankingBuilder(paymentCode: paymentCode)
                                     .name("DavidBilly")
                                     .email("[email protected]")
                                     .mobileNo("0888888888")
                                     .build()

Map<String, dynamic> paymentCode = {
   'channelCode': '123',
   'agentCode': 'THUOB',
   'agentChannelCode': 'IBANKING'
};
 
Map<String, dynamic> paymentRequest = {
   'name': 'DavidBilly',
   'email': '[email protected]',
   'mobileNo': '0888888888'
};

let paymentCode = {
   'channelCode': '123',
   'agentCode': 'THUOB',
   'agentChannelCode': 'IBANKING'
};
 
let paymentRequest = {
   'name': 'DavidBilly',
   'email': '[email protected]',
   'mobileNo': '0888888888'
};

4. Prepare Transaction Request

To prepare a transaction request, refer to the parameters below.

📘
Transaction Request API Parameters
Refer to: Do Payment Request API Parameter

TransactionResultRequest transactionResultRequest = new TransactionResultRequestBuilder(paymentToken)
                                                    .with(paymentRequest)
                                                    .build();

val transactionResultRequest = TransactionResultRequestBuilder(paymentToken).apply {
       with(paymentRequest)
}.build()

TransactionResultRequest *transactionResultRequest = [[[[TransactionResultRequestBuilder alloc] initWithPaymentToken: paymentToken]
                                                          withPaymentRequest: paymentRequest]
                                                          build];

let transactionResultRequest: TransactionResultRequest = TransactionResultRequestBuilder(paymentToken: paymentToken)
                                                         .with(paymentRequest)
                                                         .build()

Map<String, dynamic> transactionResultRequest = {
   'paymentToken': paymentToken,
   'payment': {
      'code': {
        ...paymentCode
      },
      'data': {
        ...paymentRequest
      }
   }
};

let transactionResultRequest = {
   'paymentToken': paymentToken,
   'payment': {
      'code': {
        ...paymentCode
      },
      'data': {
        ...paymentRequest
      }
   }
};

5. Receive Transaction Request Response

To receive a transaction request response, refer to the parameters below.

📘
Transaction Response API Parameters
Refer to: Do Payment Response API Parameters

🚧
References
Response Code
To view payment process flows based on response code, refer to: Payment Flow Response Codes

PGWSDK.getInstance().proceedTransaction(transactionResultRequest, new APIResponseCallback<TransactionResultResponse>() {
 
     @Override
     public void onResponse(TransactionResultResponse response) {
 
          if (response.getResponseCode().equals(APIResponseCode.TransactionPaymentSlip)) {
 
               String paymentSlip = response.getData(); //Open payment slip on WebView
           } else {
 
               //Get error response and display error.
           }
     }
 
     @Override
     public void onFailure(Throwable error) {
 
          //Get error response and display error.
     }
});

PGWSDK.getInstance().proceedTransaction(transactionResultRequest, object : APIResponseCallback<TransactionResultResponse> {
 
       override fun onResponse(response: TransactionResultResponse) {
 
              if (response.responseCode == APIResponseCode.TransactionPaymentSlip) {
 
                     val paymentSlip = response.data //Open payment slip on WebView
              } else {
 
                     //Get error response and display error.
              }
       }
 
       override fun onFailure(error: Throwable) {
                     
              //Get error response and display error.
       }
})

[[PGWSDK shared] proceedTransactionWithTransactionResultRequest: transactionResultRequest response: ^(TransactionResultResponse * _Nonnull response) {
            
     if([response.responseCode isEqualToString: APIResponseCode.TransactionPaymentSlip]) {
                     
         NSString *paymentSlip = response.data; //Open payment slip on WebView
     } else {
                
         //Get error response and display error.
     }
} failure: ^(NSError * _Nonnull error) {
            
     //Get error response and display error.
}];

PGWSDK.shared.proceedTransaction(transactionResultRequest: transactionResultRequest, { (response:TransactionResultResponse) in
     
     if response.responseCode == APIResponseCode.TransactionPaymentSlip {
             
          let paymentSlip: String = response.data //Open payment slip on WebView
     } else {
                 
          //Get error response and display error.
     }
}) { (error: NSError) in
             
     //Get error response and display error.
}

PGWSDK().proceedTransaction(transactionResultRequest, (response) {
 
   if (response['responseCode'] == APIResponseCode.transactionPaymentSlip) {
 
       String paymentSlip = response['data']; //Open payment slip on WebView
   } else {
 
       //Get error response and display error.
   }
}, (error) {
 
    //Get error response and display error.
});

await RTNPGW.proceedTransaction(JSON.stringify(transactionResultRequest)).then((response: string) => {
    
    let transactionResultResponse = JSON.parse(response);
  
    if (transactionResultResponse?.responseCode == APIResponseCode.transactionPaymentSlip) {
  
        let paymentSlip = transactionResultResponse?.data; //Open payment slip on WebView
    } else {
  
        //Get error response and display error.
    }
}).catch ((error: Error) => {
    
     //Get error response and display error
});

👍
Callback for PGW Payment Authentication
Refer to: Handle PGW Payment Authentication

6. Initiate Transaction Status Inquiry

To retrieve transaction details and status, merchants must initiate the Transaction Status Inquiry API. Refer to the sample code below.

📘
Transaction Status Inquiry API
Refer to: Transaction Status Inquiry API

Full Sample Code

The following sample code demonstrates requests and parameters for each step of the process.

//Step 1: Generate payment token.
String paymentToken = "roZG9I1hk/GYjNt+BYPYbxQtKElbZDs9M5cXuEbE+Z0QTr/yUcl1oG7t0AGoOJlBhzeyBtf5mQi1UqGbjC66E85S4m63CfV/awwNbbLbkxsvfgzn0KSv7JzH3gcs/OIL";
 
//Step 2: Construct Internet Banking request.
PaymentCode paymentCode = new PaymentCode("123", "THUOB", "IBANKING");
 
PaymentRequest paymentRequest = new InternetBankingBuilder(paymentCode)
                                .setName("DavidBilly")
                                .setEmail("[email protected]")
                                .setMobileNo("0888888888")
                                .build();
 
//Step 3: Construct transaction request.
TransactionResultRequest transactionResultRequest = new TransactionResultRequestBuilder(paymentToken)
                                                    .with(paymentRequest)
                                                    .build();
 
//Step 4: Execute payment request.
PGWSDK.getInstance().proceedTransaction(transactionResultRequest, new APIResponseCallback<TransactionResultResponse>() {
 
     @Override
     public void onResponse(TransactionResultResponse response) {
 
          if (response.getResponseCode().equals(APIResponseCode.TransactionPaymentSlip)) {
 
               String paymentSlip = response.getData(); //Open payment slip on WebView
           } else {
 
               //Get error response and display error.
           }
     }
 
     @Override
     public void onFailure(Throwable error) {
 
          //Get error response and display error.
     }
});

//Step 1: Generate payment token.
val paymentToken = "roZG9I1hk/GYjNt+BYPYbxQtKElbZDs9M5cXuEbE+Z0QTr/yUcl1oG7t0AGoOJlBhzeyBtf5mQi1UqGbjC66E85S4m63CfV/awwNbbLbkxsvfgzn0KSv7JzH3gcs/OIL"
 
//Step 2: Construct Internet Banking request.
val paymentCode = PaymentCode("123", "THUOB", "IBANKING")
 
val paymentRequest = InternetBankingBuilder(paymentCode).apply {
       name("DavidBilly")
       email("[email protected]")
       mobileNo("0888888888")
}.build()
 
//Step 3: Construct transaction request.
val transactionResultRequest = TransactionResultRequestBuilder(paymentToken).apply {
       with(paymentRequest)
}.build()
 
//Step 4: Execute payment request.
PGWSDK.getInstance().proceedTransaction(transactionResultRequest, object : APIResponseCallback<TransactionResultResponse> {
 
       override fun onResponse(response: TransactionResultResponse) {
 
              if (response.responseCode == APIResponseCode.TransactionPaymentSlip) {
 
                     val paymentSlip = response.data //Open payment slip on WebView
              } else {
 
                     //Get error response and display error.
              }
       }
 
       override fun onFailure(error: Throwable) {
                     
              //Get error response and display error.
       }
})

//Step 1: Generate payment token.
NSString *paymentToken = @"roZG9I1hk/GYjNt+BYPYbxQtKElbZDs9M5cXuEbE+Z0QTr/yUcl1oG7t0AGoOJlBhzeyBtf5mQi1UqGbjC66E85S4m63CfV/awwNbbLbkxsvfgzn0KSv7JzH3gcs/OIL";
 
//Step 2: Construct Internet Banking request.
PaymentCode *paymentCode = [[PaymentCode alloc] initWithChannelCode: @"123" agentCode: @"THUOB" agentChannelCode: @"IBANKING"];
          
PaymentRequest *paymentRequest = [[[[[[InternetBankingBuilder alloc] initWithPaymentCode: paymentCode]
                                       name: @"DavidBilly"]
                                       email: @"[email protected]"]
                                       mobileNo: @"0888888888"]
                                       build];
     
//Step 3: Construct transaction request.
TransactionResultRequest *transactionResultRequest = [[[[TransactionResultRequestBuilder alloc] initWithPaymentToken: paymentToken]
                                                          withPaymentRequest: paymentRequest]
                                                          build];
 
//Step 4: Execute payment request.
[[PGWSDK shared] proceedTransactionWithTransactionResultRequest: transactionResultRequest response: ^(TransactionResultResponse * _Nonnull response) {
            
     if([response.responseCode isEqualToString: APIResponseCode.TransactionPaymentSlip]) {
                     
         NSString *paymentSlip = response.data; //Open payment slip on WebView
     } else {
                
         //Get error response and display error.
     }
} failure: ^(NSError * _Nonnull error) {
            
     //Get error response and display error.
}];

//Step 1: Generate payment token.
let paymentToken: String = "roZG9I1hk/GYjNt+BYPYbxQtKElbZDs9M5cXuEbE+Z0QTr/yUcl1oG7t0AGoOJlBhzeyBtf5mQi1UqGbjC66E85S4m63CfV/awwNbbLbkxsvfgzn0KSv7JzH3gcs/OIL"
    
//Step 2: Construct Internet Banking request.
let paymentCode: PaymentCode = PaymentCode(channelCode: "123", "THUOB", "IBANKING")
 
let paymentRequest: PaymentRequest = InternetBankingBuilder(paymentCode: paymentCode)
                                     .name("DavidBilly")
                                     .email("[email protected]")
                                     .mobileNo("0888888888")
                                     .build()
         
//Step 3: Construct transaction request.
let transactionResultRequest: TransactionResultRequest = TransactionResultRequestBuilder(paymentToken: paymentToken)
                                                         .with(paymentRequest)
                                                         .build()
         
//Step 4: Execute payment request.
PGWSDK.shared.proceedTransaction(transactionResultRequest: transactionResultRequest, { (response:TransactionResultResponse) in
     
     if response.responseCode == APIResponseCode.TransactionPaymentSlip {
             
          let paymentSlip: String = response.data //Open payment slip on WebView
     } else {
                 
          //Get error response and display error.
     }
}) { (error: NSError) in
             
     //Get error response and display error.
}

//Step 1: Generate payment token.
String paymentToken = 'roZG9I1hk/GYjNt+BYPYbxQtKElbZDs9M5cXuEbE+Z0QTr/yUcl1oG7t0AGoOJlBhzeyBtf5mQi1UqGbjC66E85S4m63CfV/awwNbbLbkxsvfgzn0KSv7JzH3gcs/OIL';
 
//Step 2: Construct Internet Banking request.
Map<String, dynamic> paymentCode = {
   'channelCode': '123',
   'agentCode': 'THUOB',
   'agentChannelCode': 'IBANKING'
};
 
Map<String, dynamic> paymentRequest = {
   'name': 'DavidBilly',
   'email': '[email protected]',
   'mobileNo': '0888888888'
};
 
//Step 3: Construct transaction request.
Map<String, dynamic> transactionResultRequest = {
   'paymentToken': paymentToken,
   'payment': {
      'code': {
        ...paymentCode
      },
      'data': {
        ...paymentRequest
      }
   }
};
 
//Step 4: Execute payment request.
PGWSDK().proceedTransaction(transactionResultRequest, (response) {
 
   if (response['responseCode'] == APIResponseCode.transactionPaymentSlip) {
 
       String paymentSlip = response['data']; //Open payment slip on WebView
   } else {
 
       //Get error response and display error.
   }
}, (error) {
 
    //Get error response and display error.
});

//Step 1: Generate payment token.
let paymentToken = 'roZG9I1hk/GYjNt+BYPYbxQtKElbZDs9M5cXuEbE+Z0QTr/yUcl1oG7t0AGoOJlBhzeyBtf5mQi1UqGbjC66E85S4m63CfV/awwNbbLbkxsvfgzn0KSv7JzH3gcs/OIL';
 
//Step 2: Construct Internet Banking request.
let paymentCode = {
   'channelCode': '123',
   'agentCode': 'THUOB',
   'agentChannelCode': 'IBANKING'
};
 
let paymentRequest = {
   'name': 'DavidBilly',
   'email': '[email protected]',
   'mobileNo': '0888888888'
};
 
//Step 3: Construct transaction request.
let transactionResultRequest = {
   'paymentToken': paymentToken,
   'payment': {
      'code': {
        ...paymentCode
      },
      'data': {
        ...paymentRequest
      }
   }
};
 
//Step 4: Execute payment request.
await RTNPGW.proceedTransaction(JSON.stringify(transactionResultRequest)).then((response: string) => {
    
    let transactionResultResponse = JSON.parse(response);
  
    if (transactionResultResponse?.responseCode == APIResponseCode.transactionPaymentSlip) {
  
        let paymentSlip = transactionResultResponse?.data; //Open payment slip on WebView
    } else {
  
        //Get error response and display error.
    }
}).catch ((error: Error) => {
    
     //Get error response and display error
});