Loa Heo Vàng - Đối tác thanh toán
    Loa Heo Vàng - Đối tác thanh toán
    • Partner
      • Get access token for partner client
        POST
      • Refresh token
        POST
      • Send verification code to speaker device
        POST
      • Register a speaker device for a partner
        POST
      • Unregister a speaker device
        POST
      • Webhook callback endpoint for payment processor to notify transaction status
        POST
      • Update status of multiple speaker devices
        PATCH
      • Create a dynamic QR code for payment
        POST
      • Get speaker device detail
        GET
    • Partner Store
      • Update store information
        PUT

    Partner

    Loa Heo Vang API Introduction#

    Welcome to the Loa Heo Vang API documentation. This guide provides an overview of how to authenticate and interact with our API securely.

    Overview#

    Loa Heo Vang provides services for managing Golden Heo Speaker accounts and functionalities. Our API enables developers to integrate these services efficiently, ensuring smooth automation and interaction with the platform.
    Ensure you use HTTPS to maintain security.

    Authentication#

    Our API uses OAuth 2.0 Client Credentials for authentication. Before calling any protected endpoints, partners must obtain an access token.
    🔗 Get Access Token for Partner Client
    Once you have an access token, include it in the Authorization header for all subsequent API requests.

    API Endpoints#

    Here are some key API endpoints to help you get started:

    Authentication & Device Management#

    Obtain Access Token
    Partners must authenticate and retrieve an access token.
    🔗 Get Access Token
    Send Verification Code to Speaker Device
    Sends a verification code to a speaker device for authentication.
    🔗 Send Verification Code
    Register a Speaker Device for a Partner
    Partners can register a new speaker device.
    🔗 Register Speaker Device
    Unregister a Speaker Device
    Removes a previously registered device.
    🔗 Unregister Speaker Device

    Payment Integration & Notifications#

    Webhook Callback for Payment Processors
    This endpoint allows payment processors to notify Loa Heo Vang of transaction statuses, ensuring seamless tracking of payments.
    🔗 Webhook Callback Endpoint
    The webhook enables real-time updates on payment processing, helping ensure transactions are recorded and reflected properly.

    Error Handling & Rate Limits#

    The API follows standard HTTP status codes for error handling and enforces rate limits to ensure fair usage. Please refer to the API documentation for details.

    Getting Started#

    1.
    Obtain API Credentials – Contact our support team to get your client_id and client_secret.
    2.
    Authenticate – Use the authentication endpoint to obtain an access token.
    3.
    Integrate with Endpoints – Use the provided API endpoints for device management and payment processing.
    For any assistance, reach out to support@loaheovang.vn.
    Happy coding! 🚀

    Changelog#

    01/08/2025#

    Added new API to update store information

    15/04/2025#

    Added more error responses for device registration and unregistration APIs when the device is not allowed for the partner

    31/03/2025#

    Added required field bankCode to the Webhook Callback for Payment Processors API endpoint
    Modified at 2025-08-01 02:39:06
    Next
    Get access token for partner client
    Built with