Skip to main content

Verify user account info​

This API to is used to verify information by phone number or bank info.

Request Body required
  • app_id int32 required

    This is a Zalopay-provided identifier specific to the merchant's service or application, established during the integration agreement for payment methods.

  • disbursement_type string required

    Specify which type of disburse: WALLET hoặc BANK

  • receiver_info string required

    The recipient's information has been encrypted using RSA public key cryptography.

  • amount int64 required

    Amount to check user can receive.

  • redirect_url string

    A deeplink or URL that redirects users back to the merchant app following the successful completion of KYC upgrade, specifically for money transfers to Zalopay wallet, provided the reform_url function is implemented.

  • time int64 required

    The time of request (unix timestamp in milliseconds), which is calculated in milliseconds, taken from the current time

  • mac string required

    Authentication information: mac = HMAC(hmac_algorihtm, mac key, hmacinput), see as below:
    - hmac_algorihtm: is a security method registered by Merchant with Zalopay, the default is HmacSHA256.
    - mac key: provided by Zalopay at registration.
    - hmac_input = app_id + | + disbursement_type + | + receiver_info (after encrypt) + | + amount + | + time.

    Please refer to secure data transmission for detailed information.

Responses

OK

Schema
  • return_code integer

    Status code.
    Please refer to status code for possible values.

  • return_message string

    Description of status code.

  • sub_return_code integer

    Staus code detail.
    Please refer to sub status code for possible values.

  • sub_return_message string

    Description of status code detail.

  • data object
  • m_u_id string

    User's identity in Zalopay.
    Note: only respond when verify by disbursement_type = "WALLET".

  • account_holder_name string

    Account holder name.
    Note: only respond when verify by disbursement_type = "BANK" and using account.

  • card_holder_name string

    Card holder name.
    Note: only respond when verify by disbursement_type = "BANK" and using card.

  • reform_url string

    To receive funds, users must upgrade their Zalopay profile. Open this link to initiate the account upgrade process.

    Note: only respond when sub_return_code = -406 or -101 (specifically for money transfers to ZaloPay wallet).

Loading...