Create virtual transaction

POST

https://api.eu-west-1.aworld.cloud/app/v1/virtual-transactions

Creates a new virtual currency transaction.
This endpoint allows users to initiate transactions such as purchases or transfers using virtual currency.

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Header Params

Body Params application/jsonRequired

Examples

Responses

🟢201Created

application/json

Virtual transaction created successfully

Body

🟠400Bad Request

🟠401Unauthorized

🟠409409

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://api.eu-west-1.aworld.cloud/app/v1/virtual-transactions' \
--header 'x-idempotency-key;' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "transactions": [
        {
            "virtualCurrencyId": "string",
            "redemptionMode": "AUTO",
            "additionalData": {
                "property1": "string",
                "property2": "string"
            },
            "amount": 1,
            "expiresAt": "2019-08-24T14:15:22.123Z",
            "destinationUserId": "string",
            "virtualTransactionGroupId": "string"
        }
    ]
}'

Response Example

{
    "transactions": [
        {
            "userId": "string",
            "virtualCurrencyId": "string",
            "virtualTransactionId": "string",
            "virtualTransactionGroupId": "string",
            "redemptionGroupId": "string",
            "redemptionMode": "AUTO",
            "state": "PENDING",
            "direction": "CREDIT",
            "initiatorType": "USER",
            "initiator": "string",
            "counterpartType": "USER",
            "counterpart": "string",
            "additionalData": {
                "property1": "string",
                "property2": "string"
            },
            "amount": 0,
            "expiresAt": "2019-08-24T14:15:22.123Z",
            "redeemedAt": "string",
            "accountId": "stringstri",
            "workspaceId": "stringstri",
            "sourceRegion": "us-east-1",
            "createdAt": "2019-08-24T14:15:22.123Z",
            "updatedAt": "2019-08-24T14:15:22.123Z"
        }
    ]
}

Modified at 2026-02-10 10:37:54

List virtual transactions

Get virtual transaction by ID