Bank Account Verification APIs

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
Production environment
POST https://api.signzy.app/api/v3/bankaccountverification/verifytransferadvanced
POST https://api.signzy.app/api/v3/bankaccountverification/verifytransferadvanced
﻿
UAT/Testing environment
POST https://api-preproduction.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
﻿
JSON
{
    "amount": "1.09",
    "signzyId": "N2AY9x4NKnqZaM8nCuj1GcEnGpbkit6IjhBpHJr1gfJ9EDQh9T57"
}
{
    "amount": "1.09",
    "signzyId": "N2AY9x4NKnqZaM8nCuj1GcEnGpbkit6IjhBpHJr1gfJ9EDQh9T57"
}
﻿
﻿
Code samples
Curl
Node.js
Python
Go
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"
}'
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.
﻿
200
400
401
404
// When no Transaction found for that signzyId
// When amount is not passed as string or wrong signzyId is passed
{
    "error": {
        "name": "error",
        "message": "Transaction not found",
        "reason": "Error",
        "type": "Not Found",
        "statusCode": 404
    }
}


// When no Transaction found for that signzyId
// When amount is not passed as string or wrong signzyId is passed
{
    "error": {
        "name": "error",
        "message": "Transaction not found",
        "reason": "Error",
        "type": "Not Found",
        "statusCode": 404
    }
}

﻿
﻿
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!

Variable Penny Drop

Introduction

Docs powered by Archbee

TABLE OF CONTENTS

Request body parameters

Code samples

Response body parameters

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.

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

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.