Notification webhook callback (demo)

Webhook callback demo the notification endpoint that partner customer must implement to receive notification from Loa Heo Vang.

To ensure the security, integrity, and trustworthiness of communications between your system and the Loa Heo Vang system, we require the implementation of two main security layers:

Transport Layer Security with mTLS (Mutual Transport Layer Security): Guarantees the confidentiality of data in transit and provides mutual authentication of both systems.

Application/Data Layer Security with Digital Signatures for Payload: Ensures the integrity of the data within the message and authenticates the origin of the message.

Adherence to these security requirements is mandatory to establish and maintain a stable and secure connection with the Loa Heo Vang system.

The endpoint must be publicly accessible and accept POST requests. The endpoint must be able to handle the following parameters:

storeId: The store id of the payment

payDate: The pay date of the payment

billNumber: The bill number of the payment

transactionAmount: The transaction amount of the payment

notice: The notice of the payment

The payload must be signed with the private key of the partner. The signature must be verified with the public key of the partner. The signature must be in the header of the request. The header name is "X-Signature".

curl --location --request POST 'https://api-test.loaheovang.com/api/v1/partner/customer/notification' \ --header 'Content-Type: application/json' \ --data-raw '{ "billNumber": "BILL202305250001", "transactionAmount": "250000", "notice": "Thanh toán hóa đơn", "storeId": "string", "payDate": "2023-05-25T14:35:12.000Z" }'

Request

Responses