Deposit Activation

Some payment systems also provide activation of deposits. In simple words, 2 more actions are added to the request processing.

Deposit activation

post

For payment system that require payment activation

Authorizations

Query parameters

project_idnumberRequired

Project ID in the A-Pay system

Example: 123

order_idstringRequired

Deposit ID in the A-Pay system

Example: 7fa13dbc3b79e05e

Body

payment_systemstring · enumRequired

Name of the payment system in A-Pay

Example: nagadPossible values:

dataone ofRequired

Data depending on the specific payment system

object · bkash_aOptional

BKash_a data (empty)

For example: "data": {}

or

or

or

or

object · bkash_bOptional

BKash_b data (empty)

For example: "data": {}

or

or

or

or

or

or

or

or

or

or

or

or

Responses

200

OK

application/json

Responseone of

or

400

Error

application/json

post

HTTPcURLJavaScriptPython

POST /Remotes/deposit-activate?project_id=1&order_id=text HTTP/1.1
Host: <domain>
apikey: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 36

{
  "payment_system": "nagad",
  "data": {}
}

{
  "success": true,
  "order_id": "7fa13dbc3b79e05e",
  "message": "Transaction was already activated",
  "code": 201,
  "data": {
    "verify_otp": true,
    "require_new_otp": false
  }
}

A perfect example of a payment system that provides for activation is upi_p2p. Let's analyze an example of request processing and activation:

1. We see that activation is required for this PS in Request to create a deposit.

2. Here we can see that in this PS A-pay sends the UPI address parameter to the client after processing the request. In this case, it means that A-pay sends the address to which the user needs to transfer money in Responses.

3. After the user has transferred money, he must activate his deposit. It transmits the necessary information to the client server. For upi_p2p this is the Transaction ID (UTR). The client server sends to A-pay an activation request, in which certain data is transmitted. After that, A-pay processes the activation request and responds to the client with success or failure, depending on the situation.

Examples of the responses:

Success

{
  "success": true,
  "order_id": "7fa13dbc3b79e05e",
  "data": {
    "verify_otp": true,
    "require_new_otp": false
  }
}

Error

{
  "success": false,
  "message": "Invalid request",
  "code": 400,
  "order_id": "7fa13dbc3b79e05e"
}