Webhook

, Configure the webhook

Sequence Diagram

Event data

Parameter
Data Type
Description

transId

String

The ID of transaction.

type

String

TRANSACTION_STATUS

transDate

String

The time of transaction.

virtualAccountId

String

The ID of virtual account.

accountName

String

The account name.

amount

Number

The amount of collection transaction.

note

String

Note.

status

String

Transaction status

reconcileStatus

String

Transaction reconcile status, Include: UPLOADED: Documents for transaction were uploaded, waiting for verifying APPROVED: Transaction documents were verified RECONCILED: Transaction was reconconciled SETTLED: Transaction was settled

payoutStatus

String

Transaction payout status, Include: READY: Transaction was settled and ready for Remitout. PROCESSING: Remitout/Payout request is processing. REJECTED: Remitout/Payout request has been rejected, SUCCESS: Remitout/Payout request has success

serviceInformation

Object

Extra data includes "code", "groupId", "desc"

secureHash

String

(Base64)

Use SHA256 to hash the above parameters (sort the key by Alphabet order) + Secret Key (configured on Merchant Portal, in the Collection service menu)

Sample data```javascript

{
    "transId": "FT246560944209",
    "type": "TRANSACTION_STATUS",
    "merchantCode": "UFLIYL",
    "transDate": "2023-10-10T07:06:37.436Z",
    "virtualAccountId": "NEO0001675",
    "accountName": "HIEP HOANG H",
    "amount": 20000,
    "note": "",
    "status": "SUCCESS",
    "reconcileStatus": "SETTLED",
    "payoutStatus": "READY",
    "serviceInformation": {
        "code": "GRAB",
        "desc": "TEST",
        "groupId": "DRIVER"
    }
}

With the secretKey "SUMTING", the string used to create secureHash will be:

HIEP HOANG H20000UFLIYLREADYSETTLEDGRABTESTDRIVERSUCCESS2023-10-10T07:06:37.436ZFT246560944209TRANSACTION_STATUSNEO0001675SUMTING

Last updated