Create Gift Card

POST

https://api-dev.getroamify.com/api/gifts/gift

Last modified:2025-01-06 23:19:20

Maintainer:Not configured

To create a gift card, you need to send a POST request to the /api/gifts/gift endpoint.

The request body should contain the following parameters:

orderId: The order ID of for your own reference. This is a required field of type string.

senderEmail: The email address of the sender. This is a required field of type string.

sender: The name of the sender. This is an optional field of type string.

amount: The amount of the gift card. This is a required field of type number.

currency: The currency of the gift card. This is a required field of type string. The currency should be in ISO 4217 format.

Request

Header Params

Content-Type

string

required

Example:

application/json

User-Agent

string

required

Example:

insomnia/10.1.0

Authorization

string

required

Example:

Body Params application/json

orderId

string

required

amount

integer

required

currency

string

required

senderEmail

string

required

sender

string

required

Example

{
  "orderId": "test-order-id-101",
  "amount": 10,
  "currency": "USD",
  "senderEmail": "test@gmail.com",
  "sender": "optional"
}

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api-dev.getroamify.com/api/gifts/gift' \
--header 'User-Agent: insomnia/10.1.0' \
--header 'Authorization: Bearer WcK7zF9wyfMgchsKYXfnyhDG8o1Lh3nCMWYDK7RKzH6FH29Lta2ax8Sxiaj86Hf22v6g7JfxjioN6dpdanodez8Ta7CiLDSZprz3cmKCVceoytFyujbGXHB1gFBtBoMx967kNRhHmPVamb59vVXRDz7H3tamQztQ7cYYrBswR2STPES3oyubToGgHt' \
--header 'Content-Type: application/json' \
--data-raw '{
	"orderId": "test-order-id-101",
	"amount": 10,
	"currency": "USD",
	"senderEmail": "test@gmail.com",
	"sender": "optional"
}'

Responses

🟢200successfully / 200

text/plain

Body

object {0}

Example

application/json; charset=utf-8 content type is not supported in the response body

Modified at 2025-01-06 23:19:20

Revoke Gift Card

Get all Gifts