These docs are for v4.0.2. Click to read the latest docs for v4.3.0.

Payment Option Details

The Payment Option Details API allows merchants to retrieve payment information based on their merchant account configuration.

Refer to the links below for parameters and code samples for each step:

 

📘

API Method

PGW SDK API Interface

🚧

References

SDK Payment Classes
SDK Payment Enums

 

1. Generate Payment Token

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

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

 

2. Receive Payment Token Response

To receive a payment token response, refer to the sample payment token response below. The response will contain the payment token ID which must be passed to the merchant application.

String 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"

📘

Payment Token API

Refer to: Payment Token API

 

3. Prepare Payment Option Detail Request

To prepare a payment option detail request, refer to the parameters below.

📘

Request API Parameters

Refer to: Payment Option Detail Request API Parameters

PaymentOptionDetailRequest paymentOptionDetailRequest = new PaymentOptionDetailRequest(paymentToken);
paymentOptionDetailRequest.setCategoryCode(PaymentChannelCode.Category.GlobalCardPayment);
paymentOptionDetailRequest.setGroupCode(PaymentChannelCode.Group.GlobalInstallmentPaymentPlan);
PaymentOptionDetailRequest *paymentOptionDetailRequest = [[PaymentOptionDetailRequest alloc] initWithPaymentToken: paymentToken];
paymentOptionDetailRequest.categoryCode = PaymentChannelCodeCategory.GlobalCardPayment;
paymentOptionDetailRequest.groupCode = PaymentChannelCodeGroup.CreditCard;
let paymentOptionDetailRequest: PaymentOptionDetailRequest = PaymentOptionDetailRequest(paymentToken: paymentToken)
paymentOptionDetailRequest.categoryCode = PaymentChannelCode.Category.GlobalCardPayment
paymentOptionDetailRequest.groupCode = PaymentChannelCode.Group.CreditCard

 

4. Receive Payment Option Detail Response

To receive a payment option detail response, refer to the parameters below.

📘

Response API Parameters

Refer to: Payment Option Detail Response API Parameters

PGWSDK.getInstance().paymentOptionDetail(paymentOptionDetailRequest, new APIResponseCallback<PaymentOptionDetailResponse>() {
 
     @Override
     public void onResponse(PaymentOptionDetailResponse response) {
         if(response.getResponseCode().equals(APIResponseCode.APISuccess)) {
              //Read Payment option details response.
         } else {
              //Get error response and display error.
         }
    }
 
    @Override
    public void onFailure(Throwable error) {
        //Get error response and display error.
    }
});
[[PGWSDK shared] paymentOptionDetailWithPaymentOptionDetailRequest: paymentOptionDetailRequest response: ^(PaymentOptionDetailResponse * _Nonnull response) {   
     if([response.responseCode isEqualToString: APIResponseCode.APISuccess]) {          
          //Read Payment option details response.
     } else { 
          //Get error response and display error. 
     }
} failure: ^(NSError * _Nonnull error) {         
     //Get error response and display error.
}];
PGWSDK.shared.paymentOptionDetail(paymentOptionDetailRequest: paymentOptionDetailRequest, { (response: PaymentOptionDetailResponse) in           
     if response.responseCode == APIResponseCode.APISuccess {                
          //Read Payment option details response.
     } else {               
          //Get error response and display error.
     }
}) { (error: NSError) in           
     //Get error response and display error.
}

 

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 payment option details request.
PaymentOptionDetailRequest paymentOptionDetailRequest = new PaymentOptionDetailRequest(paymentToken);
paymentOptionDetailRequest.setCategoryCode(PaymentChannelCode.Category.GlobalCardPayment);
paymentOptionDetailRequest.setGroupCode(PaymentChannelCode.Group.GlobalInstallmentPaymentPlan);
 
//Step 3: Retrieve payment option details response.
PGWSDK.getInstance().paymentOptionDetail(paymentOptionDetailRequest, new APIResponseCallback<PaymentOptionDetailResponse>() {
 
     @Override
     public void onResponse(PaymentOptionDetailResponse response) {
         if(response.getResponseCode().equals(APIResponseCode.APISuccess)) {
              //Read Payment option details response.
         } else {
              //Get error response and display error.
         }
    }
 
    @Override
    public void onFailure(Throwable error) {
        //Get error response and display error.
    }
});
//Step 1 : Generate payment token
NSString *paymentToken = @"roZG9I1hk/GYjNt+BYPYbxQtKElbZDs9M5cXuEbE+Z0QTr/yUcl1oG7t0AGoOJlBhzeyBtf5mQi1UqGbjC66E85S4m63CfV/awwNbbLbkxsvfgzn0KSv7JzH3gcs/OIL";
 
//Step 2: Construct payment option details request.
PaymentOptionDetailRequest *paymentOptionDetailRequest = [[PaymentOptionDetailRequest alloc] initWithPaymentToken: paymentToken];
paymentOptionDetailRequest.categoryCode = PaymentChannelCodeCategory.GlobalCardPayment;
paymentOptionDetailRequest.groupCode = PaymentChannelCodeGroup.CreditCard;
     
//Step 3: Retrieve payment option details response.
[[PGWSDK shared] paymentOptionDetailWithPaymentOptionDetailRequest: paymentOptionDetailRequest response: ^(PaymentOptionDetailResponse * _Nonnull response) {     
     if([response.responseCode isEqualToString: APIResponseCode.APISuccess]) {   
          //Read Payment option details response.
     } 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 payment option details request.
let paymentOptionDetailRequest: PaymentOptionDetailRequest = PaymentOptionDetailRequest(paymentToken: paymentToken)
paymentOptionDetailRequest.categoryCode = PaymentChannelCode.Category.GlobalCardPayment
paymentOptionDetailRequest.groupCode = PaymentChannelCode.Group.CreditCard
 
//Step 3: Retrieve payment option details response.
PGWSDK.shared.paymentOptionDetail(paymentOptionDetailRequest: paymentOptionDetailRequest, { (response: PaymentOptionDetailResponse) in          
     if response.responseCode == APIResponseCode.APISuccess {          
          //Read Payment option details response.
     } else {      
          //Get error response and display error.
     }
}) { (error: NSError) in     
     //Get error response and display error.
}