3. Query (Id)

You can use this service to query the defined gift balance using the balance's identity (Id) information.

Gift Balance Inquiry by 'Id'

GET{{WalletUrl}}/api/v1/balance/gift/:id

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 (Headers) 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 identifies the client application.

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

Parameter	Description
Id	It is the identity information of the defined gift balance. This information is returned from the Paywall API at the time of creation.

Service Reguest - JSON

{
    "Value": {
        "Id": "2344fb8a-876c-4c9a-862b-e6d07d7de819",
        "WalletId": "30bac1c0-ad6b-4c50-a52e-1b34f9b487a7",
        "Amount": 1000.00,
        "RemainingAmount": 1000.00,
        "ExpirationDate": "2026-04-29T02:00:34.426Z",
        "IsUnlimited": false,
        "Description": "KUPON100",
        "IsUsed": false,
        "IsFullyUsed": false,
        "IsPartiallyUsed": false,
        "LastTransactionId": null,
        "CreatedAt": "2025-04-30T11:28:52.399444Z",
        "UpdatedAt": null
    },
    "Errors": [],
    "IsSuccess": true,
    "IsFailure": false
}

Service Response

Parameter	Type	Description
IsFailure	bool	It returns false if the transaction failed, and true if it was successful.
IsSuccess	bool	It returns true if the transaction was successful, and false if it failed.
Errors	Array	It is an array structure containing the error details that occurred.
Value	Object	It contains a list of items that hold the result data.

Service Response (Value)

Parameter	Type	Description
Id	Guid	It is the identity number of the gift balance.
WalletId	Guid	It is the identity information of the wallet where the balance is assigned.
Amount	decimal	It is the amount of the gift balance.
RemainingAmount	decimal	It is the remaining balance amount.
ExpirationDate	DateTime	It is the expiration date of the gift balance.
IsUnlimited	bool	It indicates whether the gift balance has an expiration date. If there is an expiration date, it returns false; if there is no expiration date, it returns true.
Description	string	It is the description provided at the time of defining the gift balance.
IsUsed	bool	Has the gift balance been used?
IsFullyUsed	bool	Has the gift balance been fully used?
IsPartiallyUsed	bool	Has the gift balance been partially used?
LastTransactionId	Guid	It is the unique identifier of the last transaction.
CreatedAt	DateTime	It is the creation date of the gift balance.
UpdatedAt	DateTime	It is the update date of the gift balance.