/// <summary>
/// Creates a new payment.
/// Given a customer cellphone and the amount return a new payment.
/// </summary>
/// <returns>
/// Returns <c>LocationResponse</c> object.
/// </returns>
/// <example>
/// <code>
/// var merchant = new Vpos();
/// var location = merchant.NewPayment("900111222", "123.45");
/// </code>
/// </example>
/// <param name="customer"><c>customer</c> The customer mobile number</param>
/// <param name="amount"><c>amount</c> The amount of money being charged</param>
/// <param name="postID"><c>postID</c> the point of sale identification it defaults to the 'GPO_POS_ID' environment var</param>
/// <param name="callbackUrl"><c>callbackUrl</c> the callback url it defaults to 'PAYMENT_CALLBACK_URL' environment var</param>
public Response NewPayment(string customer, string amount, string postID = null, string callbackUrl = null)
{
IFlurlResponse result = HttpRequest("transactions")
.PostJsonAsync(new {
type = "payment",
mobile = customer,
amount,
pos_id = postID ?? this.gpoPosID,
callback_url = callbackUrl ?? this.paymentCallbackUrl
}).Result;
int status = result.StatusCode;
string message = StatusMessage.GetMessage(status);
if (status == 202)
{
var locationResponse = new Response(status, message, Utils.GetLocation(result));
return(locationResponse);
}
else
{
var errorResponse = new Response(status, message, details: Utils.GetDetails(result));
return(errorResponse);
}
}
/// <summary>
/// Creates a new refund transaction, given the parent transaction id
/// </summary>
/// <returns>
/// Returns <c>Response</c> object.
/// </returns>
/// <example>
/// <code>
/// var merchant = new Vpos();
/// var location = merchant.NewRefund("900111222", "123.45");
/// </code>
/// </example>
/// <param name="parentTransactionId"><c>parentTransactionId</c> This is a string value of the transaction id you're requesting to be refunded.</param>
/// <param name="supervisorCard"><c>supervisorCard</c> A 16 characters string digits representing the supervisor card provided by EMIS it defaults to GPO_SUPERVISOR_CARD environment var</param>
/// <param name="callbackUrl"><c>callbackUrl</c> the callback url it defaults to 'PAYMENT_CALLBACK_URL' environment var</param>
public Response NewRefund(string parentTransactionId, string supervisorCard = null, string callbackUrl = null)
{
IFlurlResponse result = HttpRequest("transactions")
.PostJsonAsync(new
{
type = "refund",
parent_transaction_id = parentTransactionId,
supervisor_card = supervisorCard ?? this.gpoSupervisorCard,
callback_url = callbackUrl ?? this.refundCallbackUrl
}).Result;
int status = result.StatusCode;
string message = StatusMessage.GetMessage(status);
if (status == 202)
{
var locationResponse = new Response(status, message, Utils.GetLocation(result));
return(locationResponse);
}
else
{
var errorResponse = new Response(status, message, details: Utils.GetDetails(result));
return(errorResponse);
}
}
/// <summary>
/// Get all transactions
/// </summary>
/// <returns>
/// Returns <c>TransactionsResponse</c> object.
/// </returns>
/// <example>
/// <code>
/// var merchant = new Vpos();
/// var transactionsResponse = merchant.GetTransactions();
/// </code>
/// </example>
public Response <List <Transaction> > GetTransactions()
{
IFlurlResponse result = HttpRequest("transactions")
.GetAsync().Result;
int status = result.StatusCode;
string message = StatusMessage.GetMessage(status);
if (status == 200)
{
var transactions = Utils.GetTransactions(result);
var TransactionsResponse = new Response <List <Transaction> >(status, message, transactions);
return(TransactionsResponse);
}
{
var errorResponse = new Response <List <Transaction> >(status, message, details: Utils.GetDetails(result));
return(errorResponse);
}
}
/// <summary>
/// Gets a single transaction.
/// Given the transaction id or and error object if the transaction was not found.
/// </summary>
/// <returns>
/// Returns <c>Response</c> object.
/// </returns>
/// <example>
/// <code>
/// var merchant = new Vpos();
/// var transaction = merchant.GetTransaction("XCSd3csdbadshg67348tgyfr");
/// </code>
/// </example>
/// <param name="transactionId"><c>transactionId</c> The id of the transaction to retrieve</param>
public Response <Transaction> GetTransaction(string transactionId)
{
IFlurlResponse result = HttpRequest($"transactions/{transactionId}")
.GetAsync().Result;
int status = result.StatusCode;
string message = StatusMessage.GetMessage(status);
if (status == 200)
{
var transaction = result.GetJsonAsync <Transaction>().Result;
Response <Transaction> transactionResponse = new Response <Transaction>(status, message, transaction);
return(transactionResponse);
}
{
var errorResponse = new Response <Transaction>(status, message, details: Utils.GetDetails(result));
return(errorResponse);
}
}
/// <summary>
/// retrieves a request
/// Given its id
/// </summary>
/// <returns>
/// Returns <c>RequestResponse</c> if the status is 200 or <c>LocationResponse</c> if the status is 303
/// </returns>
/// <example>
/// <code>
/// var merchant = new Vpos();
/// Response response = merchant.GetRequest("xSDRWFTs48unv9348ut9e");
/// if (response.status == 200)
/// {
/// // Use response.data
/// }
/// else if(response.status == 303)
/// {
/// // Use response.location
/// }
/// else
/// {
/// // User response.details
/// }
/// </code>
/// </example>
/// <param name="requestId"><c>requestId</c> The id of the request we are consulting</param>
public Response <Request> GetRequest(string requestId)
{
IFlurlResponse result = HttpRequest($"requests/{requestId}")
.GetAsync().Result;
int status = result.StatusCode;
string message = StatusMessage.GetMessage(status);
if (status == 200)
{
var request = result.GetJsonAsync <Request>().Result;
var requestResponse = new Response <Request>(status, message, request);
return(requestResponse);
}
else if (status == 303)
{
var locationResponse = new Response <Request>(status, message, location: Utils.GetLocation(result));
return(locationResponse);
}
{
var errorResponse = new Response <Request>(status, message, details: Utils.GetDetails(result));
return(errorResponse);
}
}