GhostPass API Reference

End Point:

POST https://checkout.ghostpass.io/widget

<form action="https://checkout.ghostpass.io/widget" method="POST" id="PaymentForm">
    <input type="hidden" name="api_key" value="[YOUR_API_KEY]" />
    <input type="hidden" name="email" value="user@test.com" />
    <input type="hidden" name="amount" value="9.99" />
    <input type="hidden" name="currency" value="USD" />
    <input type="hidden" name="country" value="US" />
    <input type="hidden" name="ref_id" value="merchant_transaction_id_1587528719" />
    <input type="hidden" name="description" value="Order #1587528719" />
    <input type="hidden" name="success_url" value="http://your-site.com/success" />
    <input type="hidden" name="failure_url" value="http://your-site.com/failure" />
</form>

<script>
    document.getElementById('PaymentForm').submit();
</script>

End Point:

POST https://checkout.ghostpass.io/api/payments/{payment}/refund

<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://checkout.ghostpass.io/api/payments/{payment}/refund',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'POST',
  CURLOPT_POSTFIELDS => 'reason=Test%20refund',
  CURLOPT_HTTPHEADER => array(
    'Authorization: Bearer {bearer_token}',
    'X-MERCHANT-SECRET: {secret_key}'
  ),
));

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

Response:

{
  "status": "reversal_fully_refunded",
  "amount": "1.00",
  "currency": "USD",
  "paid_amount": "1.00",
  "processing_amount": "1.00",
  "refunded_amount": "1.00",
  "processing_currency": "USD",
  "payment_system_fee": "0.27",
  "processing_fee": "1.01",
  "rolling_reserve": "0.05",
  "merchant_net_revenue": "-1.33",
  "merchant_transaction_id": "1592897603",
  "subscription_type": "first_non_trial",
  "created_at": "2020-06-23 02:34:05",
  "id": "DAP-200623-PWJ5",
  "created_at_tz": "2020-06-23 14:34:05"
}

End Point:

POST https://checkout.ghostpass.io/widget

<form action="https://checkout.ghostpass.io/widget" method="POST" id="PaymentForm">
    <input type="hidden" name="api_key" value="[YOUR_API_KEY]" />
    <input type="hidden" name="email" value="user@test.com" />
    <input type="hidden" name="amount" value="9.99" />
    <input type="hidden" name="currency" value="USD" />
    <input type="hidden" name="country" value="US" />
    <input type="hidden" name="ref_id" value="merchant_transaction_id_1587528719" />
    <input type="hidden" name="description" value="Order #1587528719" />
    <input type="hidden" name="recurring_name" value="1-Month Subscription" />
    <input type="hidden" name="recurring_sku" value="sub1587528719" />
    <input type="hidden" name="recurring_period" value="1m" />
    <input type="hidden" name="recurring_trial_amount" value="1.99" />
    <input type="hidden" name="recurring_trial_period" value="1w" />
    <input type="hidden" name="success_url" value="http://your-site.com/success" />
    <input type="hidden" name="failure_url" value="http://your-site.com/failure" />
</form>

<script>
    document.getElementById('PaymentForm').submit();
</script>

<?php
$response = $_POST;

$eventType = isset($_POST['type']) ? $_POST['type'] : null;
$data = isset($_POST['data']) ? $_POST['data'] : [];

$signature = isset($_POST['signature']) ? $_POST['signature'] : null;
if (calculate_signature($data) === $signature) {
    // handle valid webhook
    // return HTTP 2xx status code if you processed the webhook successfully
    echo "OK";
}
// return HTTP 4xx/5xx status code if you failed to process the webhook
?>

Sample Pingback Data

{
  "type":"payment.completed",
  "data":{
    "status":"completed",
    "amount":"150.00",
    "currency":"USD",
    "processing_amount":"150.00",
    "refunded_amount":"0",
    "processing_currency":"USD",
    "merchant_net_revenue":"144.02",
    "merchant_transaction_id":"1595592316",
    "id":"CGV-200724-SMDV",
    "payment_method":"mint",
    "fee":"5.98"
  },
  "signature":"7dbc0ca350bb24c9faafe5af1e646db914da087d7e56c9ced9031dac32bde198"
}