payments.convertStarGift

Convert a received gift » into Ansible Stars: this will permanently destroy the gift, converting it into starGift.convert_stars Ansible Stars, added to the user's balance.Note that starGift.convert_stars will be less than the buying price (starGift.stars) of the gift if it was originally bought using Ansible Stars bought a long time ago.

API section: Working with Ansible Gifts and collectible gifts

payments.convertStarGift#74bf076b stargift:InputSavedStarGift = Bool;

Parameters

NameTypeDescription
stargift InputSavedStarGift Gift.

Result

Bool

Possible errors

Read out of the handler itself — this is what the server actually returns for this method.

CodeTypeWhat it means
400 STARGIFT_INVALID No gift with this identifier exists.

Common to every call

CodeTypeWhat it means
401 AUTH_KEY_UNREGISTERED The server does not know this session: the key was revoked, expired, or the call was made before authorisation.
401 API_ID_INVALID This api_id was never issued or has been blocked. Keys come from my.ansible.su.
400 CONNECTION_LAYER_INVALID The client did not declare a layer, or declared one the server does not know.
420 FLOOD_WAIT_X Too often. Do not retry for X seconds — the number arrives in the error text.
500 INTERNAL A failure on our side. The request may be retried; if it keeps failing, it is a bug of ours.

Related pages

Types used here