Confirmation/Notification/Order Processing API

Confirm Transaction Status

VoguePay sends a transaction id to the notification URL provided in your account for every transaction on that account. If your notification URL i.e notify_url query parameter value is 'https://mydomain.com/n.php', then notification will be sent to :

mydomain.com/n.php

Confirm Transaction Status

GET https://pay.voguepay.com

This endpoint returns details of a transaction. See Response sample is 'Response' Tab.

Query Parameters

NameTypeDescription

v_transaction_id

string

Transaction ID of transaction to be queried.

type

string

Format for the expected data. e.g xml, json. Defaults to xml

v_merchant_id

string

Merchant ID

{
    "cur": "NGN",
    "total_paid_by_buyer": "1000",
    "total": "1000",
    "fund_maturity": "1970-01-01",
    "buyer_email": "ajayishegs@gmail.com",
    "status": "Approved",
    "merchant_id": "sandbox_760e43f202878f651659820234cad9",
    "merchant_ref": "ref123",
    "transaction_id": "409a283ede12461aa674d3abb9f9b92e",
    "process_duration": 0.836074
}

// -------------- XML RESPONSE TYPE -------------------

<?xml version="1.0" encoding="UTF-8"?>
<voguepay>
    <cur>NGN</cur>
    <total_paid_by_buyer>1000</total_paid_by_buyer>
    <total>1000</total>
    <fund_maturity>1970-01-01</fund_maturity>
    <buyer_email>ajayishegs@gmail.com</buyer_email>
    <status>Approved</status>
    <merchant_id>sandbox_760e43f202878f651659820234cad9</merchant_id>
    <merchant_ref>ref123</merchant_ref>
    <transaction_id>409a283ede12461aa674d3abb9f9b92e</transaction_id>
    <process_duration>0.566156</process_duration>
</voguepay>

Response Parameters Description

Response Key

Value

merchant_id

Merchant's ID

transaction_id

Transaction ID of the transaction requested

total_paid_by_buyer

Total amount paid by buyer including any other charges.

total

Total price of products paid for.

fund_maturity

The date that the merchant will be able to withdraw or spend the amount credited to his/her wallet as a result of this transaction.

buyer_email

Email address of buyer.

status

Status of transaction which can either be Approved, Declined, Partially Refunded or Fully Refunded.

merchant_ref

merchant_ref value sent by the merchant.

process_duration

Time transaction took to complete.

cur

Currency in which transaction was executed

Response for Transaction ID not found:

Response "status" value will be "Declined"

{
    "cur": "",
    "total_paid_by_buyer": "0",
    "total": "0",
    "fund_maturity": "1970-01-01",
    "buyer_email": "",
    "status": "Declined",
    "merchant_id": "sandbox_760e43f202878f651659820234cad9",
    "merchant_ref": "",
    "transaction_id": "409a283ede12461aa674d3abb9f9b9",
    "process_duration": 0.448289
}

Last updated