Verify Amount

Introduction

The "Verify Transfer" step is a critical part of the Variable Penny Drop API, focusing on confirming the deposited amount. This verification step ensures the rightful ownership of the bank account. It requires the signzyReferenceId obtained from the first step and the exact amount deposited. Users submit these details via the API to cross-verify the transaction. A successful verification response confirms the match of the deposited amount and reveals the account owner's name, thus completing the authentication process. This step solidifies the security and accuracy of the account verification process, crucial for financial transactions.

API details

Endpoint

POST https://api.signzy.app/api/v3/bankaccountverification/verifytransferadvanced

POST https://api-preproduction.signzy.app/api/v3/bankaccountverification/verifytransferadvanced

Request headers

Name	Value	Required	Description
Content-Type	application/json	Mandatory	The type of content that the request body contains.
Authorization	XXXXXXXXXXXXXXX	Mandatory	An authentication token to authorize the request. Reach out to the Signzy support team to get one created.

Request body parameters

Parameter	Data Type	Description	Required
amount	String	The amount that was transacted from the account.	Mandatory
signzyId	String	Reference ID associated with the transaction. This is returned as "signzyReferenceId" in Variable Penny Drop API	Mandatory

{
    "amount": "1.09",
    "signzyId": "N2AY9x4NKnqZaM8nCuj1GcEnGpbkit6IjhBpHJr1gfJ9EDQh9T57"
}

Code samples

curl --location 'https://api-preproduction.signzy.app/api/v3/bankaccountverification/verifytransferadvanced' \
--header 'Content-Type: application/json' \
--header 'Authorization: <Your access token>' \
--data '{
    "amount": "1.09",
    "signzyId": "N2AY9x4NKnqZaM8nCuj1GcEnGpbkit6IjhBpHJr1gfJ9EDQh9T57"
}'

Response body parameters

Parameter	Data Type	Description
result	Object	Contains the result of the task.
result.amountMatch	String	Indicates whether the transacted amount matches the input amount. true/ false
result.owerName	String	The account holder's name.
result.mobile	String	Mobile number of the beneficiary.
result.mmid	String	The Mobile Money Identifier (MMID) of the beneficiary associated with the bank account.

// True match 
{
    "result": {
        "amountMatch": "true",
        "owerName": "ADITYA  UPADHYAY",
        "mobile": "",
        "mmid": ""
    }
}
// False match or Invalid Transaction 
{
    "result": {
        "amountMatch": "false",
        "owerName": "",
        "mobile": "",
        "mmid": ""
    }
}

Contact Us for Any Assistance

If you have any questions or need assistance, please reach out to our customer support team. You can contact us via email at [email protected]. We strive to provide prompt and reliable assistance, ensuring your queries are addressed effectively.

We value your feedback and are committed to making your experience smooth and enjoyable. Our team is dedicated to assisting you with any needs you may have. Thank you for choosing our services. We look forward to helping you!