Mock Bank Verification

curl --request POST \ --url https://sandbox.zapyd.com/cms/api/v1/bank/mock-bank-verification \ --header 'Content-Type: application/json' \ --header 'X-API-KEY: <api-key>' \ --header 'X-SIGNATURE: <api-key>' \ --header 'X-TIMESTAMP: <api-key>' \ --data ' { "customer_id": "c2cf861b-342b-4318-a90e-85cd0312e82f", "bank_id": "cab47575-bbcb-4294-81a3-30774104f3b6", "bank_status": "VERIFIED" } '

{ "status": true, "message": "Success", "data": { "id": "4e6f1b20-a73c-11ec-b909-0242ac120002", "customer_id": "550e8400-e29b-41d4-a716-446655440000", "country": "IND", "bank_account_type": "ACCOUNT_DETAILS", "identifiers": { "account_number": "7627389201", "ifsc": "SBIN0001829" }, "account_number": "7627389201", "ifsc": "SBIN0001829", "bank_account_status": "VERIFIED", "beneficiary_name": "JOHN DOE", "bank_name": "State Bank of India", "failure_reason": null } }

Error Codes and Messages

API Status Code	Response	Reason
400	Customer not found or access denied	Customer not found, or not in your organization
400	Bank account not found or access denied	Bank account not found, or not linked to this customer
400	Failure reason is required when bank status is FAILED	`bank_status` is `FAILED` without `failure_reason`
400	Mock bank verification is only allowed in non-production environment.	Called in production
500	Internal Server Error	Internal Server Error

Authorizations

X-API-KEY

string

header

required

API Key for authentication

X-TIMESTAMP

string

header

required

Current timestamp in seconds since epoch

X-SIGNATURE

string

header

required

HMAC SHA256 signature of the request encoded in Base64

Body

application/json

customer_id

string<uuid>

required

Zapyd customer ID (UUID) returned by Create Customer.

Example:

"c2cf861b-342b-4318-a90e-85cd0312e82f"

bank_id

string<uuid>

required

Bank account ID returned by Add Bank Account.

Example:

"cab47575-bbcb-4294-81a3-30774104f3b6"

bank_status

enum<string>

required

Result to set

Available options:

VERIFIED,

FAILED,

MANUAL_REVIEW

Example:

"VERIFIED"

failure_reason

enum<string>

Required when bank_status is FAILED. Use a real reason so your error handling gets tested.

Available options:

INVALID_IFSC,

INVALID_ACCOUNT_NUMBER,

ACCOUNT_TYPE_NRE,

PENNY_DROP_FAILED,

NAME_MISMATCH,

BANK_RISK_CHECK_FAILED

Example:

"NAME_MISMATCH"

Response

Bank account status updated

status

boolean

Example:

true

message

string

Example:

"Success"

data

object

Show child attributes

Getting started

Customers

KYC

Bank accounts

Wallets

Payout-only onboarding

Payins

Payouts

Prefunded payouts

Remittance (India)

Limits and EDD

Widget

Reference

Mock Bank Verification

Error Codes and Messages

Authorizations

Body

Response

​Error Codes and Messages

Authorizations

Body

Response

Error Codes and Messages