arrow_back Back to all endpoints
POST https://test-api.finerworks.com/v3/buy_account_credits

Buy Account Credits

This does not automatically create an account credit in one's account.This adds it to one's shopping cart for later checkout. Only authorized accounts may use this endpoint.

Body

Name Description Type Additional information
amount Min is $100 (USD). Max allowed is $5000 (USD) decimal

Required

Range: inclusive between 100 and 5000

cart_id Cart to assign the account credit to text

Required

extra_credits Percentage of extra credits this will be valued at. decimal None.
account_key Optional - User account associated with the request. Note, this will only be accepted for accounts with permission to utilize this parameter, otherwise it will be ignored and the request will based upon the user's api credentials. Leave as null if not authorized to use this parameter. text None.

Example JSON Body

application/json, text/json

{
  "amount": 1.0,
  "cart_id": "sample string 2",
  "extra_credits": 3.0,
  "account_key": "sample string 4"
}

Sample Code Library

curl --location --request POST 'https://test-api.finerworks.com/v3/buy_account_credits' \
--header 'Content-Type: application/json' \
--header 'web_api_key: my-web-api-key-goes-here' \
--header 'app_key: my-app-key-goes-here' \
--data-raw '{
  "amount": 1.0,
  "cart_id": "sample string 2",
  "extra_credits": 3.0,
  "account_key": "sample string 4"
}'