com.binance.connector.client.impl.spot

Class GiftCard

java.lang.Object

com.binance.connector.client.impl.spot.GiftCard

public class GiftCard
extends Object

Gift Card Endpoints

All endpoints under the Gift Card Endpoint section of the API documentation will be implemented in this class.
Response will be returned in String format.

Constructor Summary

Constructors

Constructor and Description
GiftCard(String baseUrl, String apiKey, com.binance.connector.client.utils.signaturegenerator.SignatureGenerator signatureGenerator, boolean showLimitUsage, com.binance.connector.client.utils.ProxyAuth proxy)
GiftCard(String baseUrl, String apiKey, String secretKey, boolean showLimitUsage, com.binance.connector.client.utils.ProxyAuth proxy)

Method Summary

Modifier and Type	Method and Description
String	createCode(Map<String,Object> parameters) This API is for creating a Binance Code.
String	createDualTokensCode(Map<String,Object> parameters) This API is for buying a fixed-value Binance Code, which means your Binance Code will be redeemable to a token that is different to the token that you are paying in.
String	redeemCode(Map<String,Object> parameters) This API is for redeeming the Binance Code.
String	rsaPublicKey(Map<String,Object> parameters) This API is for fetching the RSA Public Key.
String	tokensLimit(Map<String,Object> parameters) This API is to help you verify which tokens are available for you to purchase fixed-value gift cards.
String	verify(Map<String,Object> parameters) This API is for verifying whether the Binance Code is valid or not by entering Binance Code or reference number.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

GiftCard

public GiftCard(String baseUrl,
                String apiKey,
                String secretKey,
                boolean showLimitUsage,
                com.binance.connector.client.utils.ProxyAuth proxy)

GiftCard

public GiftCard(String baseUrl,
                String apiKey,
                com.binance.connector.client.utils.signaturegenerator.SignatureGenerator signatureGenerator,
                boolean showLimitUsage,
                com.binance.connector.client.utils.ProxyAuth proxy)

Method Detail

createCode

public String createCode(Map<String,Object> parameters)

This API is for creating a Binance Code. To get started with, please make sure: You have a Binance account
You have passed kyc
You have a sufficient balance in your Binance funding wallet
You need Enable Withdrawals for the API Key which requests this endpoint.


POST /sapi/v1/giftcard/createCode

Parameters:

parameters - Map of String,Object pair where String is the name of the parameter and Object is the value of the parameter

token -- mandatory/string -- The coin type contained in the Binance Code
amount -- mandatory/double -- The amount of the coin
recvWindow -- optional/long

Returns:

String

See Also:

https://binance-docs.github.io/apidocs/spot/en/#create-a-single-token-gift-card-user_data

redeemCode

public String redeemCode(Map<String,Object> parameters)

This API is for redeeming the Binance Code. Once redeemed, the coins will be deposited in your funding wallet.
Please note that if you enter the wrong code 5 times within 24 hours, you will no longer be able to redeem any Binance Code that day.


POST /sapi/v1/giftcard/redeemCode

Parameters:

parameters - Map of String,Object pair where String is the name of the parameter and Object is the value of the parameter

code -- mandatory/string -- Binance code
externalUid -- optional/string -- Each external unique ID represents a unique user on the partner platform. The function helps you to identify the redemption behavior of different users, such as redemption frequency and amount. It also helps risk and limit control of a single account, such as daily limit on redemption volume, frequency, and incorrect number of entries. This will also prevent a single user account reach the partner's daily redemption limits. We strongly recommend you to use this feature and transfer us the User ID of your users if you have different users redeeming Binance codes on your platform. To protect user data privacy, you may choose to transfer the user id in any desired format (max. 400 characters).
recvWindow -- optional/long

Returns:

String

See Also:

https://binance-docs.github.io/apidocs/spot/en/#redeem-a-binance-gift-card-user_data

verify

public String verify(Map<String,Object> parameters)

This API is for verifying whether the Binance Code is valid or not by entering Binance Code or reference number.
Please note that if you enter the wrong binance code 5 times within an hour, you will no longer be able to verify any binance code for that hour.


GET /sapi/v1/giftcard/verify

Parameters:

parameters - Map of String,Object pair where String is the name of the parameter and Object is the value of the parameter

referenceNo -- mandatory/string -- reference number
recvWindow -- optional/long

Returns:

String

See Also:

https://binance-docs.github.io/apidocs/spot/en/#verify-binance-gift-card-by-gift-card-number-user_data

rsaPublicKey

public String rsaPublicKey(Map<String,Object> parameters)

This API is for fetching the RSA Public Key. This RSA Public key will be used to encrypt the card code.

GET /sapi/v1/giftcard/cryptography/rsa-public-key

Parameters:

parameters - Map of String,Object pair where String is the name of the parameter and Object is the value of the parameter

recvWindow -- optional/long

Returns:

String

See Also:

https://binance-docs.github.io/apidocs/spot/en/#fetch-rsa-public-key-user_data

createDualTokensCode

public String createDualTokensCode(Map<String,Object> parameters)

This API is for buying a fixed-value Binance Code, which means your Binance Code will be redeemable to a token that is different to the token that you are paying in. If the token you’re paying and the redeemable token are the same, please use the Create Binance Code endpoint. You can use supported crypto currency or fiat token as baseToken to buy Binance Code that is redeemable to your chosen faceToken. Once successfully purchased, the amount of baseToken would be deducted from your funding wallet. To get started with, please make sure: - You have a Binance account - You have passed kyc - You have a sufficient balance in your Binance funding wallet - You need Enable Withdrawals for the API Key which requests this endpoint.

POST /sapi/v1/giftcard/buyCode

Parameters:

parameters - Map of String,Object pair where String is the name of the parameter and Object is the value of the parameter

baseToken -- mandatory/string -- The token you want to pay, example BUSD
faceToken -- mandatory/string -- The token you want to buy, example BNB. If faceToken = baseToken, it's the same as createCode endpoint.
baseTokenAmount -- mandatory/double -- The base token asset quantity, example 1.002
discount -- optional/double -- The discount rate, example 0.1
recvWindow -- optional/long -- The value cannot be greater than 60000

Returns:

String

See Also:

https://binance-docs.github.io/apidocs/spot/en/#create-a-dual-token-gift-card-fixed-value-discount-feature-trade

tokensLimit

public String tokensLimit(Map<String,Object> parameters)

This API is to help you verify which tokens are available for you to purchase fixed-value gift cards.

GET /sapi/v1/giftcard/buyCode/token-limit

Parameters:

parameters - Map of String,Object pair where String is the name of the parameter and Object is the value of the parameter

baseToken -- mandatory/string -- The token you want to pay, example BUSD
recvWindow -- optional/long -- The value cannot be greater than 60000

Returns:

String

See Also:

https://binance-docs.github.io/apidocs/spot/en/#fetch-token-limit-user_data