Developer ZoneRecipesAPI ReferenceChangelog
Developer Zone
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
ParameterData TypeMandatoryDescription
Constructors (paymentCode, token)PaymentCode, StringC

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, StringC

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')

expiryMonthIntegerO

Credit card expiry month

  • Only used to update card token expiry month

expiryYearIntegerO

Credit card expiry year

  • Only used to update card token expiry year.

securityCodeStringOCredit card security code
pinStringOCredit card PIN
installmentInterestTypeStringC

Installment interest type
Refer to: Installment Interest Type Code

installmentPeriodIntegerCInstallment period, in months
fxRateIdStringO

Exchange rate ID
Refer to: Exchange Rate Response API

emailStringOCustomer’s email address
mobileNoStringOCustomer’s mobile number
userAddressUserAddressO

Customer's address
userAddress:
Refer to: User Address
User Address Builder:
Refer to: User Address For Payment

paymentExpiryStringO

Payment 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

 

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


Class CardPaymentBuilder
ParameterData TypeMandatoryDescription
Constructors (paymentCode, cardNo)PaymentCode, StringC

Init class constructor with payment code and credit card number
• SDK constructor
• Refer to: Payment Code

Constructors (channelCode, cardNo)String, StringC

Init 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
tokenizeBooleanC

Allows customer to tokenize card information
Allows merchant to indicate if the Store Card feature is enabled
• false – No (default)
• true – Yes

installmentInterestTypeStringC

Installment interest type
Refer to: Installment Interest Type Code

installmentPeriodIntegerCInstallment period, in months
fxRateIdStringO

Exchange rate ID
Refer to: Exchange Rate Response API

nameStringOCustomer’s name
emailStringOCustomer’s email address
mobileNoStringOCustomer’s mobile number
userAddressUserAddressO

Customer's address
userAddress:
Refer to: User Address
User Address Builder:
Refer to: User Address For Payment

paymentExpiryStringO

Payment 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

 

Internet Banking (IMBANK)


Class InternetBankingBuilder
ParameterData TypeMandatoryDescription
Constructors (paymentCode)PaymentCodeC

Init class constructor with payment code
• SDK constructor
• Refer Payment Code

Constructors (channelCode, agentCode, agentChannelCode)String, String, StringC

Init class constructor with payment channel code, agent code and agent channel code
• SDK constructor
• agentChannelCode: Refer to Payment Option Detail Response API

fxRateIdStringO

Exchange rate ID
Refer to: Exchange Rate Response API

nameStringOCustomer’s name
emailStringOCustomer’s email address
mobileNoStringOCustomer’s mobile number
userAddressUserAddressO

Customer's address
userAddress:
Refer to: User Address
User Address Builder:
Refer to: User Address For Payment

paymentExpiryStringO

Payment 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

 

Pay At Counter (COUNTER)


Class PayAtCounterBuilder
ParameterData TypeMandatoryDescription
Constructors (paymentCode)PaymentCodeC

Init class constructor with payment code
• SDK constructor
• Refer Payment Code

Constructors (channelCode, agentCode, agentChannelCode)String, String, StringC

Init class constructor with payment channel code, agent code and agent channel code
• SDK constructor
• agentChannelCode: Refer to Payment Option Detail Response API

fxRateIdStringO

Exchange rate ID
Refer to: Exchange Rate Response API

nameStringOCustomer’s name
emailStringOCustomer’s email address
mobileNoStringOCustomer’s mobile number
userAddressUserAddressO

Customer's address
userAddress:
Refer to: User Address
User Address Builder:
Refer to: User Address For Payment

paymentExpiryStringO

Payment 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)PaymentCodeC

Init class constructor with payment code
• SDK constructor
• Refer Payment Code

Constructors (channelCode, agentCode, agentChannelCode)String, String, StringC

Init class constructor with payment channel code, agent code and agent channel code
• SDK constructor
• agentChannelCode: Refer to Payment Option Detail Response API

fxRateIdStringO

Exchange rate ID
Refer to: Exchange Rate Response API

nameStringOCustomer’s name
emailStringOCustomer’s email address
mobileNoStringOCustomer’s mobile number
userAddressUserAddressO

Customer's address
userAddress:
Refer to: User Address
User Address Builder:
Refer to: User Address For Payment

paymentExpiryStringO

Payment 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

 

Web Payment (WEBPAY)


Class WebPaymentBuilder
ParameterData TypeMandatoryDescription
Constructors (paymentCode)PaymentCodeC

Init class constructor with payment code
• SDK constructor
• Refer Payment Code

Constructors (channelCode, agentCode, agentChannelCode)String, String, StringC

Init class constructor with payment channel code, agent code and agent channel code
• SDK constructor
• agentChannelCode: Refer to Payment Option Detail Response API

fxRateIdStringO

Exchange rate ID
Refer to: Exchange Rate Response API

nameStringOCustomer’s name
emailStringOCustomer’s email address
mobileNoStringOCustomer’s mobile number
userAddressUserAddressO

Customer's address
userAddress:
Refer to: User Address
User Address Builder:
Refer to: User Address For Payment

paymentExpiryStringO

Payment 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

 

Digital Payment (DPAY)


Class DigitalPaymentBuilder
ParameterData TypeMandatoryDescription
Constructors (paymentCode)PaymentCodeC

Init class constructor with payment code
• SDK constructor
• Refer Payment Code

Constructors (channelCode)StringC

Init class constructor with payment channel code
• SDK constructor
• agentChannelCode: Refer Payment Option Detail Response API

accountNoStringOCustomer’s account number
tokenStringODigital payment token
fxRateIdStringO

Exchange rate ID
Refer to Exchange Rate Response API

nameStringOCustomer’s name
emailStringOCustomer’s email address
mobileNoStringOCustomer’s mobile number
userAddressUserAddressO

Customer's address
userAddress:
Refer to: User Address
User Address Builder:
Refer to: User Address For Payment

paymentExpiryStringO

Payment 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

 

QR Payment (QR)


Class QRPaymentBuilder
ParameterData TypeMandatoryDescription
Constructors (paymentCode)PaymentCodeC

Init class constructor with payment code
• SDK constructor
• Refer Payment Code

Constructors (channelCode)StringC

Init class constructor with payment channel code
• SDK constructor
• agentChannelCode: Refer to: Payment Option Detail Response API

typeStringO

QR data type
Refer to: QR Type Code

fxRateIdStringO

Exchange rate ID
Refer to: Exchange Rate Response API

nameStringOCustomer’s name
emailStringOCustomer’s email address
mobileNoStringOCustomer’s mobile number
userAddressUserAddressO

Customer's address
userAddress:
Refer to: User Address
User Address Builder:
Refer to: User Address For Payment

paymentExpiryStringO

Payment 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

 

Buy Now Pay Later Payment (BNPL)


Class BuyNowPayLaterPaymentBuilder
ParameterData TypeMandatoryDescription
Constructors (paymentCode)PaymentCodeC

Init class constructor with payment code
• SDK constructor
• Refer to: Payment Code

Constructors (channelCode)StringC

Init class constructor with payment channel code, agent code and agent channel code
• SDK constructor
• agentChannelCode: Refer to: Payment Option Detail Response API

fxRateIdStringO

Exchange rate ID
Refer to: Exchange Rate Response API

nameStringOCustomer’s name
emailStringOCustomer’s email address
mobileNoStringOCustomer’s mobile number
userAddressUserAddressO

Customer's address
userAddress:
Refer to: User Address
User Address Builder:
Refer to: User Address For Payment

paymentExpiryStringO

Payment 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

 

Universal Payment (Any type of payment)


Class UniversalPaymentBuilder
ParameterData TypeMandatoryDescription
Constructors (paymentCode)PaymentCodeC

Init class constructor with payment code


• SDK constructor
• Refer to: Payment Code

Constructors (channelCode, agentCode, agentChannelCode)String, String, StringC

Init 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
tokenizeBooleanO

Allows merchant to indicate if the Store Card feature is enabled


• false – No (default)
• true – Yes

installmentInterestTypeStringO

Installment interest type


Refer to: Installment Interest Type Code

installmentPeriodIntegerOInstallment period, in months
tokenStringOToken from card token ID or digital payment
accountNoStringOCustomer’s account number
qrTypeStringO

QR data type


Refer to: QR Type Code

fxRateIdStringO

Exchange rate ID


Refer to: Exchange Rate Response API

nameStringOCustomer’s name
emailStringOCustomer’s email address
mobileNoStringOCustomer’s mobile number
userAddressUserAddressO

Customer's address


userAddress:
Refer to: User Address


User Address Builder:
Refer to: User Address For Payment

paymentExpiryStringO

Payment 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

 

Do Payment Request


Class TransactionResultRequestBuilder
ParameterData TypeMandatoryDescription

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

withPaymentRequestO

Payment 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
userBillingAddressUserBillingAddressO

Customer's billing address informationuserBillingAddress:
Refer to: User Billing Address