QuickStart - Accept Your First Payment in 5 Minutes

<script src="https://newwebpay.qa.interswitchng.com/inline-checkout.js"></script>

function paymentCallback(response) {
    console.log('Payment complete:', response);
    // response.resp === "00" means the customer completed the flow
    // IMPORTANT: Always verify server-side before giving value
}

window.webpayCheckout({
    merchant_code: "MX6072",
    pay_item_id: "9405967",
    txn_ref: "test_" + Date.now(),   // unique per transaction
    amount: 10000,                    // ₦100.00 (amount is in kobo)
    currency: 566,                    // NGN
    cust_email: "[email protected]",
    onComplete: paymentCallback,
    mode: 'TEST'
});

<form method="post" action="https://newwebpay.qa.interswitchng.com/collections/w/pay">
    <input type="hidden" name="merchant_code" value="MX6072" />
    <input type="hidden" name="pay_item_id" value="9405967" />
    <input type="hidden" name="txn_ref" value="test_12345" />
    <input type="hidden" name="amount" value="10000" />
    <input type="hidden" name="currency" value="566" />
    <input type="hidden" name="cust_email" value="[email protected]" />
    <input type="hidden" name="site_redirect_url" value="https://your-site.com/payment-response" />
    <button type="submit">Pay ₦100.00</button>
</form>

curl -X POST https://qa.interswitchng.com/collections/api/v1/pay-bill \
  -H "Content-Type: application/json" \
  -d '{
    "merchantCode": "MX6072",
    "payableCode": "9405967",
    "amount": "10000",
    "redirectUrl": "https://your-site.com/payment-response",
    "customerId": "[email protected]",
    "currencyCode": "566",
    "customerEmail": "[email protected]"
  }'

const response = await fetch('https://qa.interswitchng.com/collections/api/v1/pay-bill', {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({
        merchantCode: 'MX6072',
        payableCode: '9405967',
        amount: '10000',
        redirectUrl: 'https://your-site.com/payment-response',
        customerId: '[email protected]',
        currencyCode: '566',
        customerEmail: '[email protected]'
    })
});

const data = await response.json();
console.log(data.paymentUrl); // Send customer to this URL

import requests

response = requests.post(
    'https://qa.interswitchng.com/collections/api/v1/pay-bill',
    json={
        'merchantCode': 'MX6072',
        'payableCode': '9405967',
        'amount': '10000',
        'redirectUrl': 'https://your-site.com/payment-response',
        'customerId': '[email protected]',
        'currencyCode': '566',
        'customerEmail': '[email protected]'
    }
)

data = response.json()
print(data['paymentUrl'])  # Send customer to this URL

{
  "id": 21067,
  "merchantCode": "MX6072",
  "payableCode": "9405967",
  "amount": 10000,
  "code": "200",
  "reference": "3WuIKFZFvGWra4e",
  "paymentUrl": "https://project-x-merchant.k8.isw.la/paymentgateway/paybill/3WuIKFZFvGWra4e",
  "redirectUrl": "https://your-site.com/payment-response",
  "customerId": "[email protected]",
  "customerEmail": "[email protected]",
  "currencyCode": "566"
}

curl -X GET "https://qa.interswitchng.com/collections/api/v1/gettransaction.json?merchantcode=MX6072&transactionreference={txn_ref}&amount=10000" \
  -H "Content-Type: application/json"

const txnRef = 'test_1234567890'; // from your original request

const res = await fetch(
    `https://qa.interswitchng.com/collections/api/v1/gettransaction.json?merchantcode=MX6072&transactionreference=${txnRef}&amount=10000`,
    { headers: { 'Content-Type': 'application/json' } }
);

const txn = await res.json();

if (txn.ResponseCode === '00' && txn.Amount === 10000) {
    // Payment confirmed — deliver value
} else {
    // Payment failed or amount mismatch — do not deliver value
}

import requests

txn_ref = 'test_1234567890'  # from your original request

res = requests.get(
    'https://qa.interswitchng.com/collections/api/v1/gettransaction.json',
    params={
        'merchantcode': 'MX6072',
        'transactionreference': txn_ref,
        'amount': 10000
    }
)

txn = res.json()

if txn['ResponseCode'] == '00' and txn['Amount'] == 10000:
    # Payment confirmed — deliver value
    pass
else:
    # Payment failed or amount mismatch — do not deliver value
    pass

{
    "Amount": 10000,
    "CardNumber": "",
    "MerchantReference": "test_1234567890",
    "PaymentReference": "UBA|API|MX6072|25-07-2024|249510|719456",
    "RetrievalReferenceNumber": "000647661227",
    "SplitAccounts": [],
    "TransactionDate": "2024-07-25T06:57:24",
    "ResponseCode": "00",
    "ResponseDescription": "Approved by Financial Institution",
    "AccountNumber": "9999999999"
}