Accounts Operations
Get Account Details
Endpoint to retrieve an account details by account Id.
API Reference: Get Account by ID
Get cards by Account Id
Endpoint to retrieve all cards linked to an account by account Id.
API Reference: Get all Cards by Account ID
Get Auth Hold by Account Id
Endpoint to retrieve the authorisation hold details by account Id.
API Reference: Get all Authorisation Holds by Account ID
Block Account
Endpoint to block an account by account Id.
On a blocked account, the account status would be LOCKED.
API Reference: Block Account and Customer
Unblock Account
Endpoint to unblock a blocked account by account Id.
On an unblocked account, the account status will become ACTIVE.
API Reference: Unblock Account
Close an Account
Endpoint to close an account by account Id.
On close account,
The account status would be CLOSED . The CLOSED is a final status. There is no way to activate closed account.
All cards linked to the account will be inoperable
PayTo Mandate will be cancel if any.
In case of joint account, both the customers are allow to close an account. If the joint account has a hierarchy where one of the customers is admin then that customer can close without the others consent
In case of business account, all customer are allow to close an account. If the group account has a hierarchy where one of the customers is admin then that customer can close without the others consent
You can find more details on Account Closure
API Reference: Closes an account
Search Account
The endpoint to retrieve multiple accounts based on various search criteria.
Currently you can search by the accountNumber. In the future release, additional search criteria will be supported.
API Reference: Search accounts
Create Custom Data
The Shaype platform allows you to add your custom key-value pairs to your account during account creation and through this endpoint.
API Reference: Create Custom Data for Account
Delete Custom Data
This endpoint is used to delete all the custom data from an account.
API Reference: Delete Custom Data for Account
Create Rule for Account
This endpoint is designed to allow account-level controls over how money can be spent.
Following are the supported features:
Block a transaction based on Merchant Category Code (MCC) or Merchant Id: User can’t spend money at certain businesses - eg alcohol stores, gambling etc. Use ruleType MERCHANT_CODE_BLOCK or MERCHANT_ID_BLOCK
Block a transaction based on Merchant Name: User can’t spend money at a particular business. Use ruleType MERCHANT_NAME_BLOCK
Set a rule for a timed period: User spending is restricted for a specified time period - eg no alcohol for the next 3 days
You will receive the notification with the ruleDetail under type TRANSACTION on rule failed.
API Reference: Create Rule for Account
Get Rule for Account by Rule Id
This endpoint is used to retrieve specific rule details from account.
API Reference: Get Rule for Account by Rule ID
Get All Rules of Account
This endpoint is used to retrieve all a rules associated with the specific account.
API Reference: Get all Rules by Account ID
Delete Rule from Account
This endpoint is used to delete a rule from an account.
API Reference: Delete Rule from Account
Points to Notes
- After account creation, the account risk level is set to HIGH by default, which sets all limits to 0 and prevents any movement of funds. Changing the risk level to LOW adjusts the limits to their default non-zero values and permits transactions.
- You can change the account’s risk level by calling the Update Account Risk Level endpoint.
Updated 3 months ago