1. Create (Wallet)

You can use this service to assign gift balances to wallets.

Create Gift Balance with Wallet 'Id'

POST{{WalletUrl}}/api/v1/balance/gift

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	Required	Description
apikeypublic	string	Yes	It is the shared key information that provides general access to the API services.
apiclientpublic	string	Yes	It is the public client key information that defines the client application.

Service Reguest - JSON

{
  "WalletId": "30bac1c0-ad6b-4c50-a52e-1b34f9b487a7",
  "Amount": 1000,
  "ExpirationDate": "2026-04-29T02:00:34.426Z",
  "Description": "KUPON100"
}

Service Request

Parameter	Type	Description
WalletId	Guid	The identity information of the wallet where the gift balance will be assigned.
Amount	decimal	The gift balance to be assigned.
ExpirationDate	DateTime?	If you want the gift balance to be valid until a specific date, you can specify a date. If a date is provided, the amount will automatically become inactive if not spent by that date. If no date is provided, the amount will remain in the wallet until it is used.
Description	string	The description of the given gift balance. Example: "Birthday"

Service Reguest - JSON

{
    "Value": {
        "Id": "6a623f97-c376-44ea-8995-09dfacd0ddcf",
        "WalletId": "30bac1c0-ad6b-4c50-a52e-1b34f9b487a7",
        "Amount": 1000,
        "RemainingAmount": 1000,
        "ExpirationDate": "2026-04-29T02:00:34.426Z",
        "IsUnlimited": false,
        "Description": "KUPON100",
        "IsUsed": false,
        "IsFullyUsed": false,
        "IsPartiallyUsed": false,
        "LastTransactionId": null,
        "CreatedAt": "2025-04-30T11:11:07.516534Z",
        "UpdatedAt": null
    },
    "Errors": [],
    "IsSuccess": true,
    "IsFailure": false
}

Service Response

Parameter	Type	Description
IsFailure	bool	Returns true if the operation is successful, false otherwise.
IsSuccess	bool	Returns true if the operation is successful, false otherwise.
Errors	Array	It is an array structure containing the details of the encountered errors.
Value	Array	Contains a list of items with the result data.

Service Response (Value)

Parameter	Type	Description
Id	Guid	A unique identifier for this entity within the system.
WalletId	Guid	The unique ID of the wallet associated with the record.
Amount	string	Holds the total amount defined as a textual value.
RemainingAmount	decimal	Represents the remaining unused portion of the current balance.
ExpirationDate	decimal	Represents the expiration date of the amount in timestamp format.
IsUnlimited	string	Indicates whether the balance has an unlimited validity period ("true"/"false").
Description	string	A description of the amount or transaction, providing information to the user.
IsUsed	DateTime	Indicates the time when this amount was used at least once.
IsFullyUsed	DateTime	The date when the amount was fully consumed.
IsPartiallyUsed	decimal	Shows the amount that was only partially used.
LastTransactionId	Guid	The ID of the last transaction that used this balance.
CreatedAt	Guid	The creation date of the record (likely data type should be DateTime).
UpdatedAt	int	A UNIX timestamp indicating when the record was last updated.