pl.rspective.voucherify.client.api

Interface VoucherifyApi

public interface VoucherifyApi

An interface used internally to create a Retrofit API.

Method Summary

Modifier and Type	Method and Description
Voucher	fetch(java.lang.String code) Fetch details for a specific voucher.
Voucher	redeem(java.lang.String code, java.lang.String trackingId) Method used to redeem a voucher identified by code
Voucher	redeem(java.lang.String code, VoucherRedemptionContext redemptionContext) Method used to redeem a voucher and provide a context information.
VoucherRedemption	redemption(java.lang.String code) Fetch information about voucher redemption details

Method Detail

fetch

@GET(value="/vouchers/{code}")
Voucher fetch(@Path(value="code")
                                              java.lang.String code)

Fetch details for a specific voucher.

Parameters:

code - code of the voucher

Returns:

details of a the voucher identified by given code

redeem

@POST(value="/vouchers/{code}/redemption")
Voucher redeem(@Path(value="code")
                                                           java.lang.String code,
                                                           @Query(value="tracking_id")
                                                           java.lang.String trackingId)

Method used to redeem a voucher identified by code

Parameters:

code - code of the voucher

trackingId - an id enabling you to correlate who has redeemed the voucher

Returns:

redeem

@POST(value="/vouchers/{code}/redemption")
Voucher redeem(@Path(value="code")
                                                           java.lang.String code,
                                                           @Body
                                                           VoucherRedemptionContext redemptionContext)

Method used to redeem a voucher and provide a context information.

Parameters:

code - code of the voucher

redemptionContext - a context in terms of which the voucher is being redeemed (e.g. customer profile)

Returns:

redemption

@GET(value="/vouchers/{code}/redemption")
VoucherRedemption redemption(@Path(value="code")
                                                                        java.lang.String code)

Fetch information about voucher redemption details

Parameters:

code - of the voucher

Returns:

voucher redemption information