KNET
Copy page
Copy page as Markdown for LLMs
Open in ChatGPT
Ask questions about this page
Open in Claude
Ask questions about this page
KNET is Kuwait's national payment network operated by the Central Bank of Kuwait. It supports only debit card transactions and provides a secure payment method for customers in Kuwait. Customers are redirected to the KNET page to complete their payment before being returned to the merchant's confirmation page.
KNET transactions are processed in Kuwaiti Dinar (KWD) only and support direct capture payments exclusively.
Prerequisites
Before integrating KNET, ensure you have completed the following requirements:
-
Active KNET Service
KNET must be activated on your Amazon Payment Services account. Contact your account manager if you need activation. -
Integration Method
Choose your preferred integration approach - KNET is available through Hosted Checkout and Payment Links. -
Currency Support
KNET transactions must be processed in Kuwaiti Dinar (KWD) only.
Integration Methods
Choose the integration method that best fits your business needs and technical requirements:
Through Hosted Checkout
Redirect customers to our secure payment page with KNET support
Through Payment Links
Generate payment links with KNET support for no-code solutions
Through Hosted Checkout
Hosted Checkout provides a secure way to accept KNET payments by redirecting customers to Amazon Payment Services' payment page.
How Hosted Checkout Works
The KNET hosted checkout process follows these steps:
Payment Request
Create Payment Request
Send a POST request to the hosted checkout endpoint with the required parameters. The request must be sent from the frontend as an HTTPS POST form with payment_option
set to KNET
.
Use the appropriate endpoint based on your environment:
https://sbcheckout.payfort.com/FortAPI/paymentPage
KNET is supported with the multi-select feature. If you wish to display it on the hosted page, no additional technical efforts are required.
Sample Request
<form method="post" action="https://sbcheckout.payfort.com/FortAPI/paymentPage"
id="paymentForm" name="paymentForm">
<input type="hidden" name="command" value="PURCHASE">
<input type="hidden" name="access_code" value="s4lwuuoY5upZlZY5D6dr">
<input type="hidden" name="merchant_identifier" value="WeVJHPYm">
<input type="hidden" name="merchant_reference" value="ORD-12345-2024">
<input type="hidden" name="amount" value="2000">
<input type="hidden" name="currency" value="KWD">
<input type="hidden" name="language" value="en">
<input type="hidden" name="payment_option" value="KNET">
<input type="hidden" name="customer_email" value="test@amazon.com">
<input type="hidden" name="return_url" value="https://yoursite.com/payment-result">
<input type="hidden" name="signature" value="calculated_signature_here">
<input type="submit" value="Pay Now" class="pay-button">
</form>
Make sure merchant reference value is unique value per request.
Multiply your transaction amount by the currency decimal code per ISO code 3 before sending the amount parameter. For KWD (3 decimal places), multiply by 1000. VISA requires amounts to be rounded to end in zero. For example, 3.475 KWD becomes 3480 in your request. Example: For 2.000 KWD, send 2000 in your request.
Refer to our Signature Calculation Guide for detailed implementation instructions and code examples.
Payment Response
Handle Payment Response
After payment processing, customers are redirected back to your return_url
with the transaction results.
Sample Response
{
"command": "PURCHASE",
"access_code": "s4lwuuoY5upZlZY5D6dr",
"merchant_identifier": "WeVJHPYm",
"merchant_reference": "ORD-12345-2024",
"amount": "2000",
"currency": "KWD",
"language": "en",
"payment_option": "KNET",
"customer_email": "test@amazon.com",
"fort_id": "149295435400084008",
"response_message": "Success",
"response_code": "14000",
"status": "14",
"signature": "calculated_response_signature"
}
KNET transactions only support direct capture (PURCHASE Command). Authorization is not supported.
For detailed parameter specifications, refer to our Hosted Checkout API Reference.
Through Payment Links
KNET payment links follow standard Payment Links integration, However, specific requirements must be met for KNET to be available as a payment option:
- KNET service activation: KNET must be active on your Amazon Payment Services merchant account
- Currency requirement: Transaction currency must be set to KWD (Kuwaiti Dinar) for KNET to appear in the payment options
Check Transaction Status
To check the transaction status, refer to the Check Transaction Status section.
Handling the Response
If you have a webhook configured, check the Webhooks section to understand how we send transaction responses to your system.
Go-live
Test your integration using one of our testing cards.
Make sure to visit our go-live checklist to go live with your integration.
You can visualize KNET experience by checking our prototype.
Support
Need assistance with KNET implementation? Contact our technical support team at merchantsupport-ps@amazon.com.