Account2Card

Account2Card is used to transfer money from a company's bank account to a user's bank card. This flow lets a merchant send funds to a card that was previously created in the Paylov system.

Amount format

All A2C amounts are sent and returned in tiyin. For example, 2500000 means 25,000.00 UZS.

1. Perform Transaction

Creates an A2C transaction and sends funds to the selected user card.

Endpoint

POST {BASE_URL}/merchant/a2c/performTransaction/

Headers

Authorization: Bearer <ACCESS_TOKEN>
Content-Type: application/json

Request Body

Field	Type	Required	Description
amountInTiyin	integer	Yes	Transfer amount in tiyin
userId	string	Yes	User ID declared by the merchant
cardId	string	Yes	Card ID created in the Paylov system
externalId	string	No	Merchant-side external transaction ID

{
  "amountInTiyin": 2500000,
  "userId": "string",
  "cardId": "string",
  "externalId": "string"
}

Success Response

{
  "transactionId": "9bd1a92b-5cce-47c8-a2df-99a20836ab9e",
  "status": "0",
  "statusText": "SUCCESS"
}

Field	Type	Description
transactionId	string	A2C transaction ID
status	string	Transaction status code
statusText	string	Human-readable transaction status

Error Response

{
  "result": null,
  "error": {
    "code": "processing_error",
    "message": "processing_error",
    "data": "CARD_TYPE_NOT_SUPPORTED"
  }
}

2. Check Transaction Status

Returns the status of an A2C transaction by transactionId.

Endpoint

GET {BASE_URL}/merchant/a2c/checkTransaction/{transactionId}/

Headers

Authorization: Bearer <ACCESS_TOKEN>

Path Parameters

Field	Type	Required	Description
transactionId	string	Yes	A2C transaction ID returned by performTransaction

Success Response

{
  "status": "0",
  "statusText": "SUCCESS",
  "amountInTiyin": 2500000
}

Field	Type	Description
status	string	Transaction status code
statusText	string	Human-readable transaction status
amountInTiyin	integer	Transfer amount in tiyin

3. Check Transaction Status by External ID

Returns the status of an A2C transaction by the merchant-side externalId.

Endpoint

GET {BASE_URL}/merchant/a2c/checkTransaction/byExternalId/{externalId}/

Headers

Authorization: Bearer <ACCESS_TOKEN>

Path Parameters

Field	Type	Required	Description
externalId	string	Yes	Merchant-side external transaction ID sent in performTransaction

Success Response

{
  "status": "0",
  "statusText": "SUCCESS",
  "amountInTiyin": 2500000
}

4. Get Account Balance

Returns the merchant account deposit balance available for A2C transfers.

Endpoint

GET {BASE_URL}/merchant/a2c/balance/

Headers

Authorization: Bearer <ACCESS_TOKEN>

Success Response

{
  "balance": 50000
}

Field	Type	Description
balance	integer	Available balance in tiyin

Balance format

50000 means 500.00 UZS.

Statuses

The examples above use status: "0" for a successful transaction. See Statuses for the common Paylov status codes.