---
updatedAt: 2025-05-28T08:43:13.000Z
agentTools:
  projectIndex: https://developer.2c2p.com/llms.txt
---

# TrueMoney Wallet

The 2C2P PGW SDK allows merchants to accept payments from e-wallets such as TrueMoney.

TrueMoney Wallet is a digital wallet that customers can use for easy and secure transactions such as bills payments, top ups, and purchases in Thailand.

> 📘 API Method
>
> [PGW SDK API Interface](https://developer.2c2p.com/docs/sdk-classes-apis-interface#section-pgw-sdk-api-interface)

> 🚧 References
>
> [SDK Payment Classes](https://developer.2c2p.com/docs/sdk-classes-payment-info)\
> [SDK Payment Enums](https://developer.2c2p.com/docs/sdk-classes-payment-enums)

 

## 1. Generate Payment Token

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

> 📘 Payment Token API
>
> Refer to: [Payment Token API](https://developer.2c2p.com/docs/api-payment-token)

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

 

## 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.

```java
String paymentToken = "roZG9I1hk/GYjNt+BYPYbxQtKElbZDs9M5cXuEbE+Z0QTr/yUcl1oG7t0AGoOJlBhzeyBtf5mQi1UqGbjC66E85S4m63CfV/awwNbbLbkxsvfgzn0KSv7JzH3gcs/OIL";
```
```coffeescript Kotlin
val paymentToken = "roZG9I1hk/GYjNt+BYPYbxQtKElbZDs9M5cXuEbE+Z0QTr/yUcl1oG7t0AGoOJlBhzeyBtf5mQi1UqGbjC66E85S4m63CfV/awwNbbLbkxsvfgzn0KSv7JzH3gcs/OIL"
```
```objectivec
NSString *paymentToken = @"roZG9I1hk/GYjNt+BYPYbxQtKElbZDs9M5cXuEbE+Z0QTr/yUcl1oG7t0AGoOJlBhzeyBtf5mQi1UqGbjC66E85S4m63CfV/awwNbbLbkxsvfgzn0KSv7JzH3gcs/OIL";
```
```swift
let paymentToken: String = "roZG9I1hk/GYjNt+BYPYbxQtKElbZDs9M5cXuEbE+Z0QTr/yUcl1oG7t0AGoOJlBhzeyBtf5mQi1UqGbjC66E85S4m63CfV/awwNbbLbkxsvfgzn0KSv7JzH3gcs/OIL"
```
```coffeescript Flutter
String paymentToken = 'roZG9I1hk/GYjNt+BYPYbxQtKElbZDs9M5cXuEbE+Z0QTr/yUcl1oG7t0AGoOJlBhzeyBtf5mQi1UqGbjC66E85S4m63CfV/awwNbbLbkxsvfgzn0KSv7JzH3gcs/OIL';
```
```coffeescript React Native
let paymentToken = 'roZG9I1hk/GYjNt+BYPYbxQtKElbZDs9M5cXuEbE+Z0QTr/yUcl1oG7t0AGoOJlBhzeyBtf5mQi1UqGbjC66E85S4m63CfV/awwNbbLbkxsvfgzn0KSv7JzH3gcs/OIL';
```

 

## 3. Prepare Payment Request

To prepare an e-wallet payment request, refer to the sample code below.

> 📘 Payment Request Parameters
>
> Refer to: [Payment Request API Parameters](https://developer.2c2p.com/docs/sdk-classes-payment-request#section-digital-payment-dpay)

> 🚧 Payment Channel Matrix
>
> Refer to the below payment channel codes from [**Digital Payment**](https://developer.2c2p.com/docs/reference-payment-channels#digital-payment-ewallet--cwallet)

```java
PaymentCode paymentCode = new PaymentCode("TRUEMONEY");
 
PaymentRequest paymentRequest = new DigitalPaymentBuilder(paymentCode)
                                .setName("DavidBilly")
                                .setEmail("davidbilly@2c2p.com")
                                .setAccountNo("0070000001")
                                .build();
```
```coffeescript Kotlin
val paymentCode = PaymentCode("TRUEMONEY")
 
val paymentRequest = DigitalPaymentBuilder(paymentCode).apply {
       name("DavidBilly")
       email("davidbilly@2c2p.com")
       accountNo("0070000001")
}.build()
```
```objectivec
PaymentCode *paymentCode = [[PaymentCode alloc] initWithChannelCode: @"TRUEMONEY"];
          
PaymentRequest *paymentRequest = [[[[[[DigitalPaymentBuilder alloc] initWithPaymentCode: paymentCode]
                                       name: @"DavidBilly"]
                                       email: @"davidbilly@2c2p.com"]
                                       accountNo: @"0070000001"]
                                       build];
```
```swift
let paymentCode: PaymentCode = PaymentCode(channelCode: "TRUEMONEY")
 
let paymentRequest: PaymentRequest = DigitalPaymentBuilder(paymentCode: paymentCode)
                                     .name("DavidBilly")
                                     .email("davidbilly@2c2p.com")
                                     .accountNo("0070000001")
                                     .build()
```
```coffeescript Flutter
Map<String, dynamic> paymentCode = {
   'channelCode': 'TRUEMONEY'
};

Map<String, dynamic> paymentRequest = {
   'name': 'DavidBilly',
   'email': 'davidbilly@2c2p.com',
   'accountNo': '0070000001'
};
```
```coffeescript React Native
let paymentCode = {
   'channelCode': 'TRUEMONEY'
};

let paymentRequest = {
   'name': 'DavidBilly',
   'email': 'davidbilly@2c2p.com',
   'accountNo': '0070000001'
};
```

 

## 4. Prepare Transaction Request

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

> 📘 Transaction Request API Parameters
>
> Refer to: [Do Payment Request API Parameters](https://developer.2c2p.com/docs/sdk-classes-apis-interface#section-do-payment-request-api)

```java
TransactionResultRequest transactionResultRequest = new TransactionResultRequestBuilder(paymentToken)
                                                    .with(paymentRequest)
                                                    .build();
```
```coffeescript Kotlin
val transactionResultRequest = TransactionResultRequestBuilder(paymentToken).apply {
       with(paymentRequest)
}.build()
```
```objectivec
TransactionResultRequest *transactionResultRequest = [[[[TransactionResultRequestBuilder alloc] initWithPaymentToken: paymentToken]
                                                         withPaymentRequest: paymentRequest]
                                                         build];
```
```swift
let transactionResultRequest: TransactionResultRequest = TransactionResultRequestBuilder(paymentToken: paymentToken)
                                                         .with(paymentRequest)
                                                         .build()
```
```coffeescript Flutter
Map<String, dynamic> transactionResultRequest = {
   'paymentToken': paymentToken,
   'payment': {
      'code': {
        ...paymentCode
      },
      'data': {
        ...paymentRequest
      }
   }
};
```
```coffeescript React Native
let transactionResultRequest = {
   'paymentToken': paymentToken,
   'payment': {
      'code': {
        ...paymentCode
      },
      'data': {
        ...paymentRequest
      }
   }
};
```

<br />

## 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](https://developer.2c2p.com/docs/sdk-classes-apis-interface#section-do-payment-response-api)

> 🚧 References
>
> **Response Code**\
> To view payment process flows based on response code, refer to: [**Payment Flow Response Codes**](https://developer.2c2p.com/docs/response-code-payment-flow)

```java
PGWSDK.getInstance().proceedTransaction(transactionResultRequest, new APIResponseCallback<TransactionResultResponse>() {
    
     @Override
     public void onResponse(TransactionResultResponse response) {
    
          if (response.getResponseCode().equals(APIResponseCode.TransactionAuthenticateRedirect) || response.getResponseCode().equals(APIResponseCode.TransactionAuthenticateFullRedirect)) {
    
                String redirectUrl = response.getData(); //Open WebView
          } else if (response.getResponseCode().equals(APIResponseCode.TransactionExternalApplication)) {
    
               String deepLink = response.getData(); //Open app
          } else {
    
               //Get error response and display error.
          }
     }
    
     @Override
     public void onFailure(Throwable error) {
    
          //Get error response and display error.
     }
});
```
```coffeescript Kotlin
PGWSDK.getInstance().proceedTransaction(transactionResultRequest, object : APIResponseCallback<TransactionResultResponse> {
  
       override fun onResponse(response: TransactionResultResponse) {
  
              if (response.responseCode == APIResponseCode.TransactionAuthenticateRedirect || response.responseCode == APIResponseCode.TransactionAuthenticateFullRedirect) {
  
                     val redirectUrl = response.data //Open WebView
              } else if (response.responseCode == APIResponseCode.TransactionExternalApplication) {
  
                     val deepLink = response.data //Open external application
              } else {
  
                     //Get error response and display error.
              }
       }
  
       override fun onFailure(error: Throwable) {
  
              //Get error response and display error.
       }
})
```
```objectivec
[[PGWSDK shared] proceedTransactionWithTransactionResultRequest: transactionResultRequest response: ^(TransactionResultResponse * _Nonnull response) {
              
     if([response.responseCode isEqualToString: APIResponseCode.TransactionAuthenticateRedirect] || [response.responseCode isEqualToString: APIResponseCode.TransactionAuthenticateFullRedirect]) {
                  
          NSString *redirectUrl = response.data; //Open WebView
     } else if([response.responseCode isEqualToString: APIResponseCode.TransactionExternalApplication]) {
                  
          NSString *deepLink = response.data; //Open app
     } else {
                  
          //Get error response and display error.
     }
} failure: ^(NSError * _Nonnull error) {
              
     //Get error response and display error.
}];
```
```swift
PGWSDK.shared.proceedTransaction(transactionResultRequest: transactionResultRequest, { (response: TransactionResultResponse) in
      
     if response.responseCode == APIResponseCode.TransactionAuthenticateRedirect || response.responseCode == APIResponseCode.TransactionAuthenticateFullRedirect {
                   
           let redirectUrl: String = response.data //Open WebView
     } else if response.responseCode == APIResponseCode.TransactionExternalApplication {
                
           let deepLink: String = response.data //Open app
     } else {
                   
           //Get error response and display error.
     }
}) { (error: NSError) in
               
     //Get error response and display error.
}
```
```coffeescript Flutter
PGWSDK().proceedTransaction(transactionResultRequest, (response) {
 
   if (response['responseCode'] == APIResponseCode.transactionAuthenticateRedirect || response['responseCode'] == APIResponseCode.transactionAuthenticateFullRedirect) {
 
      String redirectUrl = response['data']; //Open WebView
   } else if (response['responseCode'] == APIResponseCode.transactionExternalApplication) {
 
      String deepLink = response['data']; //Open external application
   } else {
 
      //Get error response and display error.
   }
}, (error) {
 
    //Get error response and display error.
});
```
```coffeescript React Native
await RTNPGW.proceedTransaction(JSON.stringify(transactionResultRequest)).then((response: string) => {
   
    let transactionResultResponse = JSON.parse(response);
   
    if (transactionResultResponse?.responseCode == APIResponseCode.transactionAuthenticateRedirect || transactionResultResponse?.responseCode == APIResponseCode.transactionAuthenticateFullRedirect) {
   
        let redirectUrl = transactionResultResponse?.data; //Open WebView
    } else if (transactionResultResponse?.responseCode == APIResponseCode.transactionExternalApplication) {
  
        let deepLink = transactionResultResponse?.data; //Open external application
    } 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](https://developer.2c2p.com/docs/sdk-handle-pgw-payment-authentication)

> 👍 Callback for PGW Deep Link
>
> Refer to: [Handle PGW Deep Link](https://developer.2c2p.com/docs/sdk-references-handle-deeplink-payment-flow-by-pgw-sdk-helper)

<br />

## 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](https://developer.2c2p.com/docs/api-sdk-transaction-status-inquiry)

<br />

## Full Sample Code

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

```java
//Step 1: Generate payment token.
String paymentToken = "roZG9I1hk/GYjNt+BYPYbxQtKElbZDs9M5cXuEbE+Z0QTr/yUcl1oG7t0AGoOJlBhzeyBtf5mQi1UqGbjC66E85S4m63CfV/awwNbbLbkxsvfgzn0KSv7JzH3gcs/OIL";
    
//Step 2: Construct e-wallet request.
PaymentCode paymentCode = new PaymentCode("TRUEMONEY");
 
PaymentRequest paymentRequest = new DigitalPaymentBuilder(paymentCode)
                                .setName("DavidBilly")
                                .setEmail("davidbilly@2c2p.com")
                                .setAccountNo("0070000001")
                                .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.TransactionAuthenticateRedirect) || response.getResponseCode().equals(APIResponseCode.TransactionAuthenticateFullRedirect)) {
    
                String redirectUrl = response.getData(); //Open WebView
          } else if (response.getResponseCode().equals(APIResponseCode.TransactionExternalApplication)) {
    
               String deepLink = response.getData(); //Open external application
          } else {
    
               //Get error response and display error.
          }
     }
    
     @Override
     public void onFailure(Throwable error) {
    
          //Get error response and display error.
     }
});
```
```coffeescript Kotlin
//Step 1: Generate payment token.
val paymentToken = "roZG9I1hk/GYjNt+BYPYbxQtKElbZDs9M5cXuEbE+Z0QTr/yUcl1oG7t0AGoOJlBhzeyBtf5mQi1UqGbjC66E85S4m63CfV/awwNbbLbkxsvfgzn0KSv7JzH3gcs/OIL"
 
//Step 2: Construct e-wallet request.
val paymentCode = PaymentCode("TRUEMONEY")
 
val paymentRequest = DigitalPaymentBuilder(paymentCode).apply {
       name("DavidBilly")
       email("davidbilly@2c2p.com")
       accountNo("0070000001")
}.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.TransactionAuthenticateRedirect || response.responseCode == APIResponseCode.TransactionAuthenticateFullRedirect) {
  
                     val redirectUrl = response.data //Open WebView
              } else if (response.responseCode == APIResponseCode.TransactionExternalApplication) {
  
                     val deepLink = response.data //Open external application
              } else {
  
                     //Get error response and display error.
              }
       }
  
       override fun onFailure(error: Throwable) {
  
              //Get error response and display error.
       }
})
```
```objectivec
//Step 1: Generate payment token.
NSString *paymentToken = @"roZG9I1hk/GYjNt+BYPYbxQtKElbZDs9M5cXuEbE+Z0QTr/yUcl1oG7t0AGoOJlBhzeyBtf5mQi1UqGbjC66E85S4m63CfV/awwNbbLbkxsvfgzn0KSv7JzH3gcs/OIL";
   
//Step 2: Construct e-wallet request.
PaymentCode *paymentCode = [[PaymentCode alloc] initWithChannelCode: @"TRUEMONEY"];
          
PaymentRequest *paymentRequest = [[[[[[DigitalPaymentBuilder alloc] initWithPaymentCode: paymentCode]
                                       name: @"DavidBilly"]
                                       email: @"davidbilly@2c2p.com"]
                                       accountNo: @"0070000001"]
                                       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.TransactionAuthenticateRedirect] || [response.responseCode isEqualToString: APIResponseCode.TransactionAuthenticateFullRedirect]) {
                  
          NSString *redirectUrl = response.data; //Open WebView
     } else if([response.responseCode isEqualToString: APIResponseCode.TransactionExternalApplication]) {
                  
          NSString *deepLink = response.data; //Open external application
     } else {
                  
          //Get error response and display error.
     }
} failure: ^(NSError * _Nonnull error) {
              
     //Get error response and display error.
}];
```
```swift
//Step 1: Generate payment token.
let paymentToken: String = "roZG9I1hk/GYjNt+BYPYbxQtKElbZDs9M5cXuEbE+Z0QTr/yUcl1oG7t0AGoOJlBhzeyBtf5mQi1UqGbjC66E85S4m63CfV/awwNbbLbkxsvfgzn0KSv7JzH3gcs/OIL"
      
//Step 2: Construct e-wallet request.
let paymentCode: PaymentCode = PaymentCode(channelCode: "TRUEMONEY")
 
let paymentRequest: PaymentRequest = DigitalPaymentBuilder(paymentCode: paymentCode)
                                     .name("DavidBilly")
                                     .email("davidbilly@2c2p.com")
                                     .accountNo("0070000001")
                                     .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.TransactionAuthenticateRedirect || response.responseCode == APIResponseCode.TransactionAuthenticateFullRedirect {
                   
           let redirectUrl: String = response.data //Open WebView
     } else if response.responseCode == APIResponseCode.TransactionExternalApplication {
                
           let deepLink: String = response.data //Open external application
     } else {
                   
           //Get error response and display error.
     }
}) { (error: NSError) in
               
     //Get error response and display error.
}
```
```coffeescript Flutter
//Step 1: Generate payment token.
String paymentToken = 'roZG9I1hk/GYjNt+BYPYbxQtKElbZDs9M5cXuEbE+Z0QTr/yUcl1oG7t0AGoOJlBhzeyBtf5mQi1UqGbjC66E85S4m63CfV/awwNbbLbkxsvfgzn0KSv7JzH3gcs/OIL';
 
//Step 2: Construct e-wallet request.
Map<String, dynamic> paymentCode = {
   'channelCode': 'TRUEMONEY'
};

Map<String, dynamic> paymentRequest = {
   'name': 'DavidBilly',
   'email': 'davidbilly@2c2p.com',
   'accountNo': '0070000001'
};
 
//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.transactionAuthenticateRedirect || response['responseCode'] == APIResponseCode.transactionAuthenticateFullRedirect) {
 
      String redirectUrl = response['data']; //Open WebView
   } else if (response['responseCode'] == APIResponseCode.transactionExternalApplication) {
 
      String deepLink = response['data']; //Open external application
   } else {
 
      //Get error response and display error.
   }
}, (error) {
 
    //Get error response and display error.
});
```
```coffeescript React Native
//Step 1: Generate payment token.
let paymentToken = 'roZG9I1hk/GYjNt+BYPYbxQtKElbZDs9M5cXuEbE+Z0QTr/yUcl1oG7t0AGoOJlBhzeyBtf5mQi1UqGbjC66E85S4m63CfV/awwNbbLbkxsvfgzn0KSv7JzH3gcs/OIL';
 
//Step 2: Construct e-wallet request.
let paymentCode = {
   'channelCode': 'TRUEMONEY'
};

let paymentRequest = {
   'name': 'DavidBilly',
   'email': 'davidbilly@2c2p.com',
   'accountNo': '0070000001'
};
 
//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.transactionAuthenticateRedirect || transactionResultResponse?.responseCode == APIResponseCode.transactionAuthenticateFullRedirect) {
   
        let redirectUrl = transactionResultResponse?.data; //Open WebView
    } else if (transactionResultResponse?.responseCode == APIResponseCode.transactionExternalApplication) {
  
        let deepLink = transactionResultResponse?.data; //Open external application
    } else {
   
        //Get error response and display error.
    }
}).catch ((error: Error) => {
   
    //Get error response and display error
});
```