18. Sale/Expense (Wallet)

You can manage the sales/expense transactions made with the wallet through this service.

Sale/Expense with Wallet 'Id'

POST{{WalletUrl}}/api/v1/Wallet/purchase

Note: To use this service, it is mandatory to include the apikeypublic and apiclientpublic parameters in the Header field.

WalletAPI Address

The parameters that need to be sent to the service are as follows:

Parameter	Type	Compulsory	Description
apikeypublic	string	Yes	The general key used for API access.
apiclientpublic	string	Yes	The general key representing the API client ID.

Service Reguest - JSON

{
  "Id": "92858707-7718-435c-9ba3-3d702a3bea9b",
  "Amount": 1,
  "Description": "string",
  "ExternalReference": "{{$guid}}",
  "UseGiftBalances": false,
  "CashbackApply": false,
  "CashbackType": "Percentage",
  "CashbackValue": 50
}

Service Request

Parameter	Type	Description
Id	Guid	Identifier of the wallet where the sale/expense transaction is performed
Amount	decimal	Transaction amount
Description	string	Description of the transaction
ExternalReference	string	Transaction tracking number
UseGiftBalance	bool	If there is a defined bonus balance in the wallet where the transaction is performed, should this balance be used?
CashbackApply	bool	Should cashback be applied after the transaction?
CashbackType	string	Cashback type See: Cashback Types
CashbackValue	decimal	Cashback amount to be granted

Service Reguest - JSON

{
    "IsSuccess": true,
    "IsFailure": false,
    "Value": {
        "Id": "784f8d50-c2cc-4911-b82b-2f8f49a0b98f",
        "WalletId": "7883fb19-2359-4a9b-b917-f08a259898ed",
        "Alias": "2816220769",
        "TransactionType": "Purchase",
        "Amount": 100,
        "GiftAmount": null,
        "Description": "string",
        "ExternalReference": "8e0c7f38-d63e-4c79-b6e6-c53751d205cf",
        "CreatedAt": "2025-08-20T11:56:24.8210569Z",
        "UpdatedAt": null,
        "BalanceAfterTransaction": 99900.80,
        "SourceWalletId": null,
        "DestinationWalletId": null,
        "GiftBalanceId": null,
        "MainTransactionId": null,
        "UniqueCode": "bd0413e8-2a5f-4476-8617-57775655e322",
        "UsedGiftBalances": null,
        "CashbackAmount": 0
    }
}

Service Response

Parameter	Type	Description
IsFailure	bool	It returns true if the transaction failed, otherwise false.
IsSuccess	bool	It returns true if the transaction was successful, otherwise false.
Errors	Array	A list of error messages.
Value	Array<Items>	The data set returned as a result of the transaction.

Service Response (Value)

Parameter	Type	Description
Id	Guid	It is the unique identifier generated by the system for the transaction. It is in UUID format.
WalletId	String	It is the system identifier of the wallet where the transaction took place. It indicates which wallet the transaction is associated with.
TransactionType	String	It specifies the type of the transaction. For example, it defines transactions such as "Payment," "Refund," or "Transfer."
Amount	Decimal	It is the amount of the transaction, expressed in the currency used.
GiftAmount	Decimal	It is the amount of gift balance used in the transaction. Unlike the regular balance, it represents promotional usage.
Description	String	It is the explanatory information related to the transaction. It can be written by the user or the system.
ExternalReference	String	It is the reference number provided by an external system for the transaction. It is typically used for integration systems.
CreatedAt	DateTime	It is the date and time when the transaction was created. It is recorded according to UTC or the system time.
UpdatedAt	DateTime	It is the date and time when the transaction was last updated. It is updated whenever a change occurs.
BalanceAfterTransaction	Decimal	It is the remaining balance in the wallet after the transaction. It represents the value after account updates.
SourceWalletId	String	It is the ID of the wallet on the sender's side of the transaction. It specifies the wallet from which the money is being withdrawn.
DestinationWalletId	String	It is the ID of the wallet on the recipient's side of the transaction. It specifies the wallet into which the money is being deposited.
GiftBalanceId	Guid	It is the unique identifier for the used gift balance. It is for tracking purposes.
MainTransactionId	Guid	If this transaction is a continuation or part of another transaction, it is the ID of the parent transaction.
UniqueCode	String	It is the unique code generated by the system for the transaction. It guarantees its uniqueness.
UsedGiftBalances	List	It is the list of gift balances used in the transaction. Multiple balances can be used.
CashbackAmount	Decimal	It is the cashback amount earned as a result of the transaction. It is sourced from a campaign or promotion.