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

FieldTypeRequiredDescription
reference_idstringYesThe referenceid returned by /v1/verify/bank-account/dynamic, 6 to 80 letters, digits, hyphens or underscores.
amountstringYesThe 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

FieldTypeDescription
amount_matchstringWhether the amount you sent matches the amount credited.
ower_namestringAccount holder's name from the bank, spelled exactly as returned.
mobilestringMobile number of the account holder, when the bank returns one.
mmidstringMobile 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.