KMA Push Payment

“KMA Push Payment '' is a technology for sending notifications. For the recipient to do the transaction To pay for goods. It works like an application that can send notifications directly to other applications. For example, the shopping cart app can send a notification message to the customer's device to open the bank app. Direct payment and can keep the notification message in the notification menu for postpay payment .
 

Use Case KMA Push Payment

High level steps:
 
              Overview Sequence Diagram 
 
  • This is an API call, please refer to ’Push payment message’ API specifications (A)
  • No API required at this point - KMA application will handle notification behavior based on user’s application preference
  • No API required at this point - After end-user completes a transaction (paid, cancelled etc.) KMA application will proceed with frontend application switch while also sending status of a transaction through backend integration
  • (Optional) ’Push transaction callback’ can be provided by merchant system for Krungsri to callback with transaction status update (push mode)……… READ MORE…….. If not available, system can use ‘Push transaction inquiry’ to retrieve transaction status (pull mode)
  • Merchant system process information and display at frontend interface
              Push transaction inquiry 
 
 
              Push transaction cancellation
 

• Related API

View API Catalogs

 

Seq No. API Name API Endpoints
APush payment messagePOST /rest/api/v1/payments/push/transactions
BPush transaction inquiryPOST /rest/api/v1/payments/push/transactionStatus/inquiry
CPush transaction cancellationPOST /rest/api/v1/payments/push/transactions/cancellation

Technical Details

Partner provides one endpoint for Krungsri API to callback to your system, sample of request message can be as following
         
Request parameter   

processingStatus Indicates the processing status of a payment transaction “code”
paymentAccountNumber A payment account in masked format. Applicable only if the processingStatus is FNLD
transactionReference Unique transaction reference to identify the transaction
slipImage Slip image in base64 format. Applicable only if the processingStatus is FNLD
paymentDateTime Date and time at which all processing conditions for execution of the payment are met and payment transaction is accepted. Applicable only if the processingStatus is FNLD. Format is YYYY-MM-DDThh:mm:ss.sss in Thailand local date and time (UTC/GMT +7)
paymentReferenceIdentification A payment reference identification generated by Krungsri. Use as a reference for a payment transaction. Applicable only if the processingStatus is FNLD
paymentChannel Specifies the payment channel to be used to process the payment instruction. Applicable only if the processingStatus is FNLD
paymentBankCode Specifies the payment bank code to be used to process the payment instruction. Applicable only if the processingStatus is FNLD
         Sample request          
{
  "processingStatus": "FNLD",
  "paymentAccountNumber": "xxx-x-x0055-x",
  "transactionReference": "77f5373d-5656-48d4-afe4-80df8006346d",
  "slipImage": " iVBORw0KGgoAAAANSUhEUgAAACEAAAA3CAYA...(shorten string for document purpose)...BlrYcnACwAAAABJRU5ErkJggg==",
  "paymentDateTime": "2020-02-20T00:00:00.000",
  "paymentReferenceIdentification": "BAY23910338",
  "paymentChannel": "BAY_KMA"
  "paymentBankCode": "025"
}