API reference / KYC / Identity
Reverse penny drop: confirm amount
Checks the amount the account holder reports, in rupees, against the reference_id.
POST
/v1/verify/bank-account/dynamic/confirm- Authentication
- Bearer token
- Scope
kyc:verify
Before you integrate
- This is step 2 of 2 and needs the reference from /v1/verify/bank-account/dynamic. Each step is charged separately.
Request body
| Field | Type | Required | Description |
|---|---|---|---|
reference_id | string | Yes | The referenceid returned by /v1/verify/bank-account/dynamic, 6 to 80 letters, digits, hyphens or underscores. |
amount | string | Yes | The amount the account holder received, in rupees with up to two decimals, for example 1.05. |
Sample code
Set your key in the GRAPPI_API_KEY environment variable. Sample values are placeholders.
curl -sS -X POST 'https://grappi.ai/v1/verify/bank-account/dynamic/confirm' \
-H "Authorization: Bearer $GRAPPI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"reference_id": "ref_123456",
"amount": "1.05"
}'Sample response
{
"request_id": "req_01HZY3K8M2",
"result": {
"amount_match": "yes",
"ower_name": "ASHA RAO",
"mobile": "9876543210",
"mmid": "9123456"
}
}Response fields
| Field | Type | Description |
|---|---|---|
amount_match | string | Whether the amount you sent matches the amount credited. |
ower_name | string | Account holder's name from the bank, spelled exactly as returned. |
mobile | string | Mobile number of the account holder, when the bank returns one. |
mmid | string | Mobile money identifier of the account, when the bank returns one. |
Errors
Every failure has the same shape. A call that fails on our side or at the data source is refunded to your wallet; a "no record found" answer is charged. See the error reference.