API Reference

Create Trade

post
https://dev-api.prestmit.io/partners/v1/giftcard-trade/sell/create

Initiate a new gift card sell transaction for a user.

Common fields:

  • giftcard_id: which gift card is being sold. You can get the ID from Subcategories Endpoint.

  • amount: the total amount of the gift card transaction

  • attachments[]: images/files (e.g., card photos). Files are not included in the signing hash.

  • comments: optional notes for the trade

  • payoutMethod: where proceeds are paid (e.g., NAIRA, CEDIS, BITCOINS, USDT e.t.c)

  • payoutAddress: required if a crypto payout method is chosen

  • uniqueIdentifier: your internal reference to track this trade end-to-end e.g username of your user

Response includes trade reference, rate, total amount, status, and gift card details.

Body Params
integer

ID of giftcard the user wants to trade

integer

Amount to trade

file

Image attachments for the trade. Multiple files are accepted.

string

Optional comments for the trade

string
string

Get the list of available payout methods from the Payout Methods endpoint.

string

Crypto wallet address. Needed when a crypto payout method is selected.

string

Optional unique identifier for linking this trade to your internal systems. This could contain the transaction reference on your platform or the username for the user who initiated the trade on your end.

Headers
string
Response

Updated 2 months ago

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated 2 months ago