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

Payment Request

Init PGW SDK


Class PGWSDKParamsBuilder

Parameter

Data Type

Mandatory

Description

Constructors (apiEnvironment)

APIEnvironment

M

PGW SDK API endpoint environment

• SDK constructor
• Refer to: API Environment

clientId

String

O

Unique client ID

  • In UUID format

locale

String

O

Locale of API response

  • Based on ISO 639 codes
logBooleanOPGW SDK log information.

 

Global/Local Card Token Payment (GCARD / LCARD)


Class CardTokenPaymentBuilder

Parameter

Data Type

Mandatory

Description

Constructors (paymentCode, token)

PaymentCode, String

C

Init class constructor with payment code and card token ID.

• SDK constructor
• Refer to: Payment Code
• Token: Card token (Generated and returned by the 2C2P payment gateway if the payment's storeCard option is set to 'true')

Constructors (channelCode, token)

String, String

C

Init class constructor with payment channel code and card token ID.

• SDK constructor
• Refer to: Payment Option Detail Response API
• Token: Card token (Generated and returned by the 2C2P payment gateway if the payment's storeCard option is set to 'true')

expiryMonth

Integer

O

Credit card expiry month

  • Only used to update card token expiry month

expiryYear

Integer

O

Credit card expiry year

  • Only used to update card token expiry year.
securityCodeStringOCredit card security code
pinStringOCredit card PIN
installmentInterestTypeStringCInstallment interest type

Refer to: Installment Interest Type Code
installmentPeriodIntegerCInstallment period, in months
fxRateIdStringOExchange rate ID

Refer to: Exchange Rate Response API
emailStringOCustomer’s email address
mobileNoStringOCustomer’s mobile number
userAddressUserAddressOCustomer's address

userAddress:
Refer to: User Address

User Address Builder:
Refer to: User Address For Payment
paymentExpiryStringOPayment expiryThe date/time when the customer must complete the payment. Payments completed after the expiry date/time will be rejected.Date Format: yyyy-MM-dd HH:mm:ss

 

Global/Local Card Payment (GCARD / LCARD / LCARDIPP)


Class CardPaymentBuilder
ParameterData TypeMandatoryDescription
Constructors (paymentCode, cardNo)PaymentCode, StringCInit class constructor with payment code and credit card number

• SDK constructor
• Refer to: Payment Code
Constructors (channelCode, cardNo)String, StringCInit class constructor with payment channel code and credit card number

• SDK constructor
• Refer to: Payment Option Detail Response API
expiryMonthIntegerOCredit card expiry month
expiryYearIntegerOCredit card expiry year
securityCodeStringOCredit card security code
pinStringOCredit card PIN
bankStringOCredit card issuer bank name
countryStringOCredit card issuer country code
tokenizeBooleanCAllows customer to tokenize card information

Allows merchant to indicate if the Store Card feature is enabled

• false – No (default)
• true – Yes
installmentInterestTypeStringCInstallment interest type

Refer to: Installment Interest Type Code
installmentPeriodIntegerCInstallment period, in months
fxRateIdStringOExchange rate ID

Refer to: Exchange Rate Response API
nameStringOCustomer’s name
emailStringOCustomer’s email address
mobileNoStringOCustomer’s mobile number
userAddressUserAddressOCustomer's address

userAddress:
Refer to: User Address

User Address Builder:
Refer to: User Address For Payment
paymentExpiryStringOPayment expiryThe date/time when the customer must complete the payment. Payments completed after the expiry date/time will be rejected.Date Format : yyyy-MM-dd HH:mm:ss

 

Internet Banking (IMBANK)


Class InternetBankingBuilder
ParameterData TypeMandatoryDescription
Constructors (paymentCode)PaymentCodeCInit class constructor with payment code

• SDK constructor
• Refer Payment Code
Constructors (channelCode, agentCode, agentChannelCode)String, String, StringCInit class constructor with payment channel code, agent code and agent channel code• SDK constructor
• agentChannelCode: Refer to Payment Option Detail Response API
fxRateIdStringOExchange rate ID

Refer to: Exchange Rate Response API
nameStringOCustomer’s name
emailStringOCustomer’s email address
mobileNoStringOCustomer’s mobile number
userAddressUserAddressOCustomer's address

userAddress:
Refer to: User Address

User Address Builder:
Refer to: User Address For Payment
paymentExpiryStringOPayment expiryThe date/time when the customer must complete the payment. Payments completed after the expiry date/time will be rejected.Date Format : yyyy-MM-dd HH:mm:ss

 

Pay At Counter (COUNTER)


Class PayAtCounterBuilder
ParameterData TypeMandatoryDescription
Constructors (paymentCode)PaymentCodeCInit class constructor with payment code

• SDK constructor
• Refer Payment Code
Constructors (channelCode, agentCode, agentChannelCode)String, String, StringCInit class constructor with payment channel code, agent code and agent channel code
• SDK constructor
• agentChannelCode : Refer to: Payment Option Detail Response API
fxRateIdStringOExchange rate IF Refer to: Exchange Rate Response API
nameStringOCustomer’s name
emailStringOCustomer’s email address
mobileNoStringOCustomer’s mobile number
userAddressUserAddressOCustomer's address

userAddress:
Refer to: User Address

User Address Builder:
Refer to: User Address For Payment
paymentExpiryStringOPayment expiry.The date/time when the customer must complete the payment. Payments completed after the expiry date/time will be rejected.Date Format : yyyy-MM-dd HH:mm:ss

 

Self Service Machine (SSM)


Class SelfServiceMachineBuilder
ParameterData TypeMandatoryDescription
Constructors (paymentCode)PaymentCodeCInit class constructor with payment code

• SDK constructor
• Refer Payment Code
Constructors (channelCode, agentCode, agentChannelCode)String, String, StringCInit class constructor with payment channel code, agent code and agent channel code

• SDK constructor
• agentChannelCode : Refer to: Payment Option Detail Response API
fxRateIdStringOExchange rate ID

Refer to: Exchange Rate Response API
nameStringOCustomer’s name
emailStringOCustomer’s email address
mobileNoStringOCustomer’s mobile number
userAddressUserAddressOCustomer's address

userAddress:
Refer to: User Address

User Address Builder:
Refer to: User Address For Payment
paymentExpiryStringOPayment expiryThe date/time when the customer must complete the payment. Payments completed after the expiry date/time will be rejected.Date Format : yyyy-MM-dd HH:mm:ss

 

Web Payment (WEBPAY)


Class WebPaymentBuilder
ParameterData TypeMandatoryDescription
Constructors (paymentCode)PaymentCodeCInit class constructor with payment code 
• SDK constructor
• Refer Payment Code
Constructors (channelCode, agentCode, agentChannelCode)String, String, StringCInit class constructor with payment channel code, agent code and agent channel code

• SDK constructor
• agentChannelCode : Refer to: Payment Option Detail Response API
fxRateIdStringOExchange rate ID

Refer to: Exchange Rate Response API
nameStringOCustomer’s name
emailStringOCustomer’s email address
mobileNoStringOCustomer’s mobile number
userAddressUserAddressOCustomer's address

userAddress:
Refer to: User Address

User Address Builder:
Refer to: User Address For Payment
paymentExpiryStringOPayment expiryThe date/time when the customer must complete the payment. Payments completed after the expiry date/time will be rejected.Date Format : yyyy-MM-dd HH:mm:ss

 

Digital Payment (DPAY)


Class DigitalPaymentBuilder
ParameterData TypeMandatoryDescription
Constructors (paymentCode)PaymentCodeCInit class constructor with payment code
• SDK constructor
• Refer Payment Code
Constructors (channelCode)StringCInit class constructor with payment channel code

• SDK constructor
• agentChannelCode: Refer Payment Option Detail Response API
accountNoStringOCustomer’s account number
tokenStringODigital payment token
fxRateIdStringOExchange rate ID
Refer to Exchange Rate Response API
nameStringOCustomer’s name
emailStringOCustomer’s email address
mobileNoStringOCustomer’s mobile number
userAddressUserAddressOCustomer's address

userAddress:
Refer to: User Address

User Address Builder:
Refer to: User Address For Payment
paymentExpiryStringOPayment expiryThe date/time when the customer must complete the payment. Payments completed after the expiry date/time will be rejected.Date Format : yyyy-MM-dd HH:mm:ss

 

QR Payment (QR)


Class QRPaymentBuilder
ParameterData TypeMandatoryDescription
Constructors (paymentCode)PaymentCodeCInit class constructor with payment code
• SDK constructor
• Refer Payment Code
Constructors (channelCode)StringCInit class constructor with payment channel code

• SDK constructor
• agentChannelCode: Refer to: Payment Option Detail Response API
typeStringOQR data type

Refer to: QR Type Code
fxRateIdStringOExchange rate ID

Refer to: Exchange Rate Response API
nameStringOCustomer’s name
emailStringOCustomer’s email address
mobileNoStringOCustomer’s mobile number
userAddressUserAddressOCustomer's address

userAddress:
Refer to: User Address

User Address Builder:
Refer to: User Address For Payment
paymentExpiryStringOPayment expiryThe date/time when the customer must complete the payment. Payments completed after the expiry date/time will be rejected.Date Format : yyyy-MM-dd HH:mm:ss

 

Buy Now Pay Later Payment (BNPL)


Class BuyNowPayLaterPaymentBuilder
ParameterData TypeMandatoryDescription
Constructors (paymentCode)PaymentCodeCInit class constructor with payment code

• SDK constructor
• Refer to: Payment Code
Constructors (channelCode)StringCInit class constructor with payment channel code, agent code and agent channel code

• SDK constructor
• agentChannelCode: Refer to: Payment Option Detail Response API
fxRateIdStringOExchange rate ID

Refer to: Exchange Rate Response API
nameStringOCustomer’s name
emailStringOCustomer’s email address
mobileNoStringOCustomer’s mobile number
userAddressUserAddressOCustomer's address

userAddress:
Refer to: User Address

User Address Builder:
Refer to: User Address For Payment
paymentExpiryStringOPayment expiryThe date/time when the customer must complete the payment. Payments completed after the expiry date/time will be rejected.Date Format : yyyy-MM-dd HH:mm:ss

 

Universal Payment (Any type of payment)


Class UniversalPaymentBuilder
ParameterData TypeMandatoryDescription
Constructors (paymentCode)PaymentCodeCInit class constructor with payment code

• SDK constructor
• Refer to: Payment Code
Constructors (channelCode, agentCode, agentChannelCode)String, String, StringCInit class constructor with payment channel code, agent code and agent channel code

• SDK constructor
• agentChannelCode: Refer to: Payment Option Detail Response API
cardNoStringOCredit card number
expiryMonthIntegerOCredit card expiry month
expiryYearIntegerOCredit card expiry year
securityCodeStringOCredit card security code
pinStringOCredit card PIN
bankStringOCredit card issuer bank name
countryStringOCredit card issuer country code
tokenizeBooleanOAllows merchant to indicate if the Store Card feature is enabled

• false – No (default)
• true – Yes
installmentInterestTypeStringOInstallment interest type

Refer to: Installment Interest Type Code
installmentPeriodIntegerOInstallment period, in months
tokenStringOToken from card token ID or digital payment
accountNoStringOCustomer’s account number
qrTypeStringOQR data type

Refer to: QR Type Code
fxRateIdStringOExchange rate ID

Refer to: Exchange Rate Response API
nameStringOCustomer’s name
emailStringOCustomer’s email address
mobileNoStringOCustomer’s mobile number
userAddressUserAddressOCustomer's address

userAddress:
Refer to: User Address

User Address Builder:
Refer to: User Address For Payment
paymentExpiryStringOPayment expiryThe date/time when the customer must complete the payment. Payments completed after the expiry date/time will be rejected.Date Format : yyyy-MM-dd HH:mm:ss

 

Do Payment Request


Class TransactionResultRequestBuilder

Parameter

Data Type

Mandatory

Description

Constructors (paymentToken)

String

M

Init class constructor with payment token ID

• SDK constructor
• retrieve from Payment Token API

clientId

String

O

Unique client ID

  • In UUID format

locale

String

O

Locale of API response.

  • Based on ISO 639 codes

  • If locale is empty, the API will respond based on the payment token locale.

  • If locale is indicated, the API will respond with the requested locale

  • If the clientID is indicated, the API will respond with the user's selected locale

withPaymentRequestOPayment request from payment builder
Refer to: Payment Request.

Payment request builder:
Global/Local Card Token Payment
Global/Local Card Payment
Internet Banking
Pay At Counter
Self-Service Machine
Web Payment
Digital Payment
QR Payment
Buy Now Pay Later Payment
Universal Payment

 

User Address For Payment


Class UserAddressBuilder
ParameterData TypeMandatoryDescription
Constructors ()CInit class constructor
userBillingAddressUserBillingAddressOCustomer's billing address informationuserBillingAddress:
Refer to: User Billing Address