C Stripe: Retrieve a Coupon

Back to Index

Retrieves the coupon with the given ID.

Documentation: https://stripe.com/docs/api/curl#retrieve_coupon

CURL Command

curl https://api.stripe.com/v1/coupons/25OFF \
   -u STRIPE_SECRET_KEY:

C Example

#include <C_CkRest.h>
#include <C_CkStringBuilder.h>
#include <C_CkJsonObject.h>

void ChilkatSample(void)
    {
    HCkRest rest;
    BOOL success;
    BOOL bTls;
    int port;
    BOOL bAutoReconnect;
    HCkStringBuilder sbResponseBody;
    HCkJsonObject jsonResponse;
    const char *id;
    const char *object;
    BOOL amount_off;
    int created;
    BOOL currency;
    const char *duration;
    int duration_in_months;
    BOOL livemode;
    BOOL max_redemptions;
    int percent_off;
    BOOL redeem_by;
    int times_redeemed;
    BOOL valid;

    rest = CkRest_Create();

    //  URL: https://api.stripe.com/v1/coupons/25OFF
    bTls = TRUE;
    port = 443;
    bAutoReconnect = TRUE;
    success = CkRest_Connect(rest,"api.stripe.com",port,bTls,bAutoReconnect);
    if (success != TRUE) {
        printf("ConnectFailReason: %d\n",CkRest_getConnectFailReason(rest));
        printf("%s\n",CkRest_lastErrorText(rest));
        CkRest_Dispose(rest);
        return;
    }

    CkRest_SetAuthBasic(rest,"STRIPE_SECRET_KEY","");

    sbResponseBody = CkStringBuilder_Create();
    success = CkRest_FullRequestNoBodySb(rest,"GET","/v1/coupons/25OFF",sbResponseBody);
    if (success != TRUE) {
        printf("%s\n",CkRest_lastErrorText(rest));
        CkRest_Dispose(rest);
        CkStringBuilder_Dispose(sbResponseBody);
        return;
    }

    jsonResponse = CkJsonObject_Create();
    CkJsonObject_LoadSb(jsonResponse,sbResponseBody);

    id = CkJsonObject_stringOf(jsonResponse,"id");
    object = CkJsonObject_stringOf(jsonResponse,"object");
    amount_off = CkJsonObject_IsNullOf(jsonResponse,"amount_off");
    created = CkJsonObject_IntOf(jsonResponse,"created");
    currency = CkJsonObject_IsNullOf(jsonResponse,"currency");
    duration = CkJsonObject_stringOf(jsonResponse,"duration");
    duration_in_months = CkJsonObject_IntOf(jsonResponse,"duration_in_months");
    livemode = CkJsonObject_BoolOf(jsonResponse,"livemode");
    max_redemptions = CkJsonObject_IsNullOf(jsonResponse,"max_redemptions");
    percent_off = CkJsonObject_IntOf(jsonResponse,"percent_off");
    redeem_by = CkJsonObject_IsNullOf(jsonResponse,"redeem_by");
    times_redeemed = CkJsonObject_IntOf(jsonResponse,"times_redeemed");
    valid = CkJsonObject_BoolOf(jsonResponse,"valid");


    CkRest_Dispose(rest);
    CkStringBuilder_Dispose(sbResponseBody);
    CkJsonObject_Dispose(jsonResponse);

    }

Sample JSON Response Body

{
  "id": "25OFF",
  "object": "coupon",
  "amount_off": null,
  "created": 1516662783,
  "currency": null,
  "duration": "repeating",
  "duration_in_months": 3,
  "livemode": false,
  "max_redemptions": null,
  "metadata": {},
  "percent_off": 25,
  "redeem_by": null,
  "times_redeemed": 0,
  "valid": true
}