Skip to main content

Create Deposit

Create a deposit request using the _id value you received from the Available Banks service.

Request

KeyTypeDescription
bankIdstringThe _id value you receive from the Available Banks service
amountdecimalDeposit amount
userIdstringYour user's ID in your system
namestringYour user's username
userNamestringYour user's first and last name
processIdstringAn ID value that will be unique to you for each transaction
POST - /api/transactions/deposit
curl -X POST "http://your-api-endpoint/api/transactions/deposit" \
-H "Content-Type: application/json" \
-H "ApiKey: your_api_key" \
-d '{
"bankId": "5fe0f093bb4f0b001b5ea63d",
"amount": 100,
"userId": "601e7af1-dd69-4fb6-9251-4874a86bf711",
"name": "John Doe",
"userName": "johndoe",
"processId": "34887bf0-dfc5-4d4c-bf38-e6f3ecea4404"
}'

Response

KeyTypeDescription
transactionIdstringThe unique ID number we give you when creating a transaction
bankIdstringRelevant bank id value
amountdecimalThe amount value you sent when creating the deposit transaction
userIdstringThe userId value you sent when creating the deposit transaction
namestringThe name value you sent when creating the deposit transaction
userNamestringThe userName value you sent when creating the deposit transaction
processIdstringThe processId value you sent when creating the deposit transaction
typestringTransaction type ( deposit )
convertedNamestringA 'slugified' version of the name value you sent when creating the deposit transaction
statusstringTransaction status ( pending )
bankstringName of the relevant bank
bankAccountNamestringBank account name where the deposit was made
bankAccountIbanstringBank account number where the deposit was made
hashstringSignature created by us for callback verification
  {
"data": {
"transactionId": "613a0dbd63f54d00182f6414",
"bankId": "5fe25f6e3e73770018d47b15",
"amount": 100,
"userId": "123456789",
"name": "Test User",
"userName": "testUserName",
"processId": "1122334455",
"type": "deposit",
"convertedName": "testuser",
"status": "pending",
"bank": "Fake Bank",
"bankAccountName": "Fake Bank Account Name",
"bankAccountIban": "TR280006276256222621885935",
"hash": "ENWnqnoIYk5OG2yKtYQnXqByrSB9X65ehS6oKVU/d0E="
},
"status": 200,
"errorMessage": null
}