NYYU Logo
APIDeposit

Create Bank Deposit Request

Initiate a bank deposit transaction for secure fiat currency deposits into your wallet

đŸĻ

Create Bank Deposit Request

Initiate a bank deposit transaction for secure fiat currency deposits into your wallet

Overview

The bankForDeposit mutation allows users to create a bank deposit request. This endpoint initiates an empty bank deposit transaction that can be later confirmed by an admin once the bank transfer is received and verified. This is a two-step process where users first create the request, then transfer funds via bank, and finally an admin confirms the deposit.

🔧 Mutation Schema

bankForDeposit: String

Parameters

â„šī¸No Parameters Required

This mutation does not require any input parameters. It creates an empty bank deposit transaction that will be populated with details during the admin confirmation step.

Return Value

String

The mutation returns a string indicating the result of the bank deposit request creation. This typically includes:

✓
Success Message
Confirmation that the bank deposit request was successfully created
#
Transaction Reference
May include a transaction ID or reference number for tracking

Example Usage

Example Mutation

The following example demonstrates how to create a bank deposit request:

mutation {
  bankForDeposit
}

Example Response

{
  "data": {
    "bankForDeposit": "Bank deposit request created successfully. Transaction ID: BDT_123456789"
  }
}

Deposit Process Flow

Step-by-Step Process

1
Create Deposit Request

User initiates a bank deposit request using this mutation

2
Receive Bank Details

System provides bank account details for the transfer

3
Make Bank Transfer

User transfers funds to the provided bank account

4
Admin Confirmation

Admin verifies the bank transfer and confirms the deposit using confirmBankDeposit

5
Funds Credited

Upon confirmation, funds are credited to the user's wallet

Use Cases

đŸ’ĩ

Fiat Deposits

Enable users to deposit fiat currency directly from their bank accounts into the platform wallet.

🔐

Secure Transfers

Utilize traditional banking infrastructure for secure, traceable fiat currency transfers.

📋

Compliance

Maintain regulatory compliance with manual verification and admin approval for bank deposits.

🌍

Large Deposits

Support large-value deposits through traditional wire transfers and bank channels.

Important Notes

Manual Verification Required

Bank deposit requests require manual verification and confirmation by an admin. This process may take several hours to a few business days depending on the bank transfer processing time and admin availability.

Next Steps

After creating the bank deposit request, users should receive bank account details for making the transfer. Once the transfer is completed, users should notify support or wait for the admin to verify and confirm the deposit using the confirmBankDeposit mutation.

💡 Best Practices

  • â€ĸSave the transaction ID returned from this mutation for future reference and tracking
  • â€ĸInclude the transaction ID in the bank transfer reference to facilitate faster verification
  • â€ĸKeep proof of the bank transfer (receipt, screenshot) for dispute resolution if needed
  • â€ĸNotify customer support after completing the bank transfer to expedite verification
  • â€ĸCheck the status of your deposit request periodically using the appropriate query

Confirm Bank Deposit

Admin endpoint to verify and confirm bank deposit transactions

confirmBankDeposit

View Deposit Status

Query endpoints to check the status of bank deposit transactions

getBankDepositTxnsByUser