SSLCommerz SANDBOX
Back to Home Create Account

Invoice of SSLCOMMERZ

In this section you'll find basic information to know create invoice and collect payment by scaning QR and Payment Link.

Demonstration Create Sandbox Account

Overview

Why Invoice

It is a easy way to collect the payment from your customer. You can print the SSLCOMMERZ QR in your invoice and at the time of delivery, customer can scan and pay the invoice amount. Also you can share Invoice Payment Link through SMS, Email or Facebook Messenger to collect the payment

Add QR in Your Invoice

You can past the SSLCOMMERZ QR in your invoice and send the Payment Link through SMS/Email

Payment Process Environment

We have both Live environment and Test/Sandbox environment in SSLCOMMERZ. You just need to use proper URL and Store ID's to process payments. We provide separate store ID for live and test

Live Environment

All the transaction made using this environment are counted as real transaction, URL starts with https://securepay.sslcommerz.com

Sandbox Environment

All the transaction made using this environment are counted as test transaction and has no effect with accounting, URL starts with https://sandbox.sslcommerz.com.

Test Credit Card Account Numbers

VISA:

  • Card Number: 4111111111111111
  • Exp: 12/25
  • CVV: 111

Mastercard:

  • Card Number: 5111111111111111
  • Exp: 12/25
  • CVV: 111

American Express:

  • Card Number: 371111111111111
  • Exp: 12/25
  • CVV: 111

Mobile OTP: 111111 or 123456

Create Invoice

Ready the Parameters

Some mandatory parameters need to pass to SSLCOMMERZ. It identify your customers and orders. Also you have to pass the success, fail, cancel url to redirect your customer after pay.

REST API
API Endpoint (Sandbox/Test Environment): https://sandbox.sslcommerz.com/gwprocess/v4/invoice.php
API Endpoint (Live Environment): https://securepay.sslcommerz.com/gwprocess/v4/invoice.php
Method: POST

API Request

Param Name Data Type Description
Integration Required Parameters
store_id string (30) Mandatory - Your SSLCOMMERZ Store ID is the integration credential which can be collected through our managers
store_passwd string (30) Mandatory - Your SSLCOMMERZ Store Password is the integration credential which can be collected through our managers
refer string (30) Mandatory - This reference number you will get in SSLCOMMERZ panel. However for sandbox testing, you can use as "5B1F9DE4D82B6".
total_amount decimal (10,2) Mandatory - The amount which will process by SSLCOMMERZ. It shall be decimal value (10,2). Example : 55.40. The transaction amount must be from 10.00 BDT to 500000.00 BDT
currency string (3) Mandatory - The currency type must be mentioned. It shall be three characters. Example : BDT, USD, EUR, SGD, INR, MYR, etc. If the transaction currency is not BDT, then it will be converted to BDT based on the current convert rate. Example : 1 USD = 82.22 BDT.
tran_id string (30) Mandatory - Unique transaction ID to identify your order in both your end and SSLCOMMERZ
acct_no string (50) Mandatory - You can share a reference id or invoice id from your system.
product_category string (50) Mandatory - Mention the product category. It is a open field. Example - clothing,shoes,watches,gift,healthcare, jewellery,top up,toys,baby care,pants,laptop,donation,etc
is_bangla_qr_enabled string (3) YES/NO. If 'YES', it will generate the Bangla QR.

Bangla QR is a standardized QR (Quick Response) code-based payment system in Bangladesh, launched by the Bangladesh Bank.

Note: To obtain this Bangla QR via API, please communicate with your SSLCOMMERZ Business KAM along with your production store ID.
is_sent_email string (3) yes / no. If 'yes', then it will send invoice to customer's email address.
is_sent_sms string (3) yes / no. If 'yes', then it will send invoice payment link through sms to customer's mobile number. But you must be registered in isms.sslwireless.com. This feature will be used in next update,
ipn_url string (255) Important! Not mandatory,
however better to use to avoid missing any payment notification - It is the Instant Payment Notification (IPN) URL of your website where SSLCOMMERZ will send the transaction's status (Length: 255). The data will be communicated as SSLCOMMERZ Server to your Server. So, customer session will not work. IPN is very important feature to integrate with your site(s). Some transaction could be pending or customer lost his/her session, in such cases back-end IPN plays a very important role to update your backend office.
Parameters to Handle EMI Transaction
emi_option integer (1) Mandatory - This is mandatory if transaction is EMI enabled and Value must be 1/0. Here, 1 means customer will get EMI facility for this transaction
emi_max_inst_option integer (2) Max instalment Option, Here customer will get 3,6, 9 instalment at gateway page
emi_selected_inst integer (2) Customer has selected from your Site, So no instalment option will be displayed at gateway page
emi_allow_only integer (1) Value is 1/0, if value is 1 then only EMI transaction is possible, in payment page. No Mobile banking and internet banking channel will not display. This parameter depends on emi_option and emi_selected_inst
Customer Information
cus_name string (50) Mandatory - Your customer name to address the customer in payment receipt email
cus_email string (50) Mandatory - Valid email address of your customer to send payment receipt from SSLCOMMERZ end
cus_add1 string (50) Mandatory - Address of your customer. Not mandatory but useful if provided
cus_add2 string (50) Address line 2 of your customer. Not mandatory but useful if provided
cus_city string (50) Mandatory - City of your customer. Not mandatory but useful if provided
cus_state string (50) State of your customer. Not mandatory but useful if provided
cus_postcode string (30) Mandatory - Postcode of your customer. Not mandatory but useful if provided
cus_country string (50) Mandatory - Country of your customer. Not mandatory but useful if provided
cus_phone string (20) Mandatory - The phone/mobile number of your customer to contact if any issue arises
cus_fax string (20) Fax number of your customer. Not mandatory but useful if provided
Shipment Information
shipping_method string (50) Mandatory - Shipping method of the order. Example: YES or NO or Courier
num_of_item integer (1) Mandatory - No of product will be shipped. Example: 1 or 2 or etc
ship_name string (50) Mandatory, if shipping_method is YES - Shipping Address of your order. Not mandatory but useful if provided
ship_add1 string (50) Mandatory, if shipping_method is YES - Additional Shipping Address of your order. Not mandatory but useful if provided
ship_add2 string (50) Additional Shipping Address of your order. Not mandatory but useful if provided
ship_city string (50) Mandatory, if shipping_method is YES - Shipping city of your order. Not mandatory but useful if provided
ship_state string (50) Shipping state of your order. Not mandatory but useful if provided
ship_postcode string (50) Mandatory, if shipping_method is YES - Shipping postcode of your order. Not mandatory but useful if provided
ship_country string (50) Mandatory, if shipping_method is YES - Shipping country of your order. Not mandatory but useful if provided
Product Information
product_name string (255) Mandatory - Mention the product name briefly. Mention the product name by coma separate. Example: Computer,Speaker
product_category string (100) Mandatory - Mention the product category. Example: Electronic or topup or bus ticket or air ticket
product_profile string (100) Mandatory - Mention goods vertical. It is very much necessary for online transactions to avoid chargeback.
Please use the below keys:
  1. general
  2. physical-goods
  3. non-physical-goods
  4. airline-tickets
  5. travel-vertical
  6. telecom-vertical
hours_till_departure string (30) Mandatory, if product_profile is airline-tickets - Provide the remaining time of departure of flight till at the time of purchasing the ticket. Example: 12 hrs or 36 hrs
flight_type string (30) Mandatory, if product_profile is airline-tickets - Provide the flight type. Example: Oneway or Return or Multistop
pnr string (50) Mandatory, if product_profile is airline-tickets - Provide the PNR.
journey_from_to string (255) Mandatory, if product_profile is airline-tickets - Provide the journey route. Example: DAC-CGP or DAC-CGP CGP-DAC
third_party_booking string (20) Mandatory, if product_profile is airline-tickets - No/Yes. Whether the ticket has been taken from third party booking system.
hotel_name string (255) Mandatory, if product_profile is travel-vertical - Please provide the hotel name. Example: Sheraton
length_of_stay string (30) Mandatory, if product_profile is travel-vertical - How long stay in hotel. Example: 2 days
check_in_time string (30) Mandatory, if product_profile is travel-vertical - Checking hours for the hotel room. Example: 24 hrs
hotel_city string (50) Mandatory, if product_profile is travel-vertical - Location of the hotel. Example: Dhaka
product_type string (30) Mandatory, if product_profile is telecom-vertical - For mobile or any recharge, this information is necessary. Example: Prepaid or Postpaid
topup_number string (150) Mandatory, if product_profile is telecom-vertical - Provide the mobile number which will be recharged. Example: 8801700000000 or 8801700000000,8801900000000
country_topup string (30) Mandatory, if product_profile is telecom-vertical - Provide the country name in where the service is given. Example: Bangladesh
cart json JSON data with two elements. product : Max 255 characters, quantity : Quantity in numeric value and amount : Decimal (12,2)
Example:
[{"product":"DHK TO BRS AC A1","quantity":"1","amount":"200.00"},{"product":"DHK TO BRS AC A2","quantity":"1","amount":"200.00"},{"product":"DHK TO BRS AC A3","quantity":"1","amount":"200.00"},{"product":"DHK TO BRS AC A4","quantity":"2","amount":"200.00"}]
product_amount decimal (10,2) Product price which will be displayed in your merchant panel and will help you to reconcile the transaction. It shall be decimal value (10,2). Example : 50.40
vat decimal (10,2) The VAT included on the product price which will be displayed in your merchant panel and will help you to reconcile the transaction. It shall be decimal value (10,2). Example : 4.00
discount_amount decimal (10,2) Discount given on the invoice which will be displayed in your merchant panel and will help you to reconcile the transaction. It shall be decimal value (10,2). Example : 2.00
convenience_fee decimal (10,2) Any convenience fee imposed on the invoice which will be displayed in your merchant panel and will help you to reconcile the transaction. It shall be decimal value (10,2). Example : 3.00
Customized or Additional Parameters
value_a string (255) Extra parameter to pass your meta data if it is needed. Not mandatory
value_b string (255) Extra parameter to pass your meta data if it is needed. Not mandatory
value_c string (255) Extra parameter to pass your meta data if it is needed. Not mandatory
value_d string (255) Extra parameter to pass your meta data if it is needed. Not mandatory

Sample Request

                            
                            $ curl -X POST https://sandbox.sslcommerz.com/gwprocess/v4/invoice.php
                            -d
                            'store_id=testbox&
                            store_passwd=qwerty&
                            refer=5B1F9DE4D82B6&
                            acct_no=CUST_REF_01&
                            total_amount=100&
                            currency=EUR&
                            tran_id=REF123&
                            cus_name=Customer Name&
                            cus_email=cust@yahoo.com&
                            cus_add1=Dhaka&
                            cus_add2=Dhaka&
                            cus_city=Dhaka&
                            cus_state=Dhaka&
                            cus_postcode=1000&
                            cus_country=Bangladesh&
                            cus_phone=01711111111&
                            cus_fax=01711111111&
                            ship_name=Customer Name&
                            ship_add1 =Dhaka&
                            ship_add2=Dhaka&
                            ship_city=Dhaka&
                            ship_state=Dhaka&
                            ship_postcode=1000&
                            ship_country=Bangladesh&
                            shipping_method=YES&
                            product_name=topup&
                            product_category=recharge&
                            product_profile=telecom-vertical&
                            num_of_item=1&
                            value_a=ref001_A&
                            value_b=ref002_B&
                            value_c=ref003_C&
                            value_d=ref004_D'

Sample Response

                        

                        {
                        "status":"success",
                        "error_reason":"",

                        "invoice_refer":"5B1F9DE4D82B6",
                        "pay_url":"https:\/\/sandbox.sslcommerz.com\/gwprocess\/v4\/pay.php?refer=TEST-INV5F4A76D33255D",
                        "qr_image_url":""
                        "qr_image_pay_url":"https:\/\/merchant.sslcommerz.com\/web\/images\/generateQR.php?QR=https:\/\/sandbox.sslcommerz.com\/gwprocess\/v4\/pay.php?refer=TEST-INV5F4A76D33255D"
                        "invoice_id":"TEST-INV5F4A76D33255D"
                        "email_sending_status":"NO"
                        "sms_sending_status":"NO"
                        "bangla_qr_code":"0002010102120216402004005000003704152713770100000031531416100500052044600000000500003952040763530305054031005802BD5908EASY_APP6005DHAKA62610309S-6BBB-310715T3184D269DF8CB10125BQ202507241520216881FAD5663049D32"
                        }

API Response

Param Name Data Type Description
status string (10) API connectivity status. If all the required data is provided, then it will return as success, neither it will be failed
error_reason string (255) If API connectivity is failed then it returns the reason.
invoice_refer string (50) The refer has been shared at the time of request.
pay_url string (256) This is the Invoice Payment Link which could be shared by SMS, Email, Facebook Messenger and others to collect the payment
qr_image_pay_url string (255) This is the QR of the payment link. It is a image. So you can use to display this QR in your web site. Also you can print in your customer invoice to scan and pay.
invoice_id string (50) This is a unique invoice id generated by SSLCOMMERZ Invoice System. You can use this inoivr id to check the payment status. Therefore, you may store this invoice id in your system.
email_sending_status string (20) Email sending status. Example: YES / NO / FAILED / NOT_READY
sms_sending_status string (20) SMS sending status. Example: YES / NO / FAILED / NOT_READY
bangla_qr_code string (500) The content of the Bangla QR is based on this text. You will generate the QR using this content and display it to the customer to collect the payment.

Invoice Payment Status

You can query your invoice payment status while you want. For ticketing system or product limitation, it will help you to release before recheck.

By invoice_id

You can check the status of a transaction by the invoice_id
So, Let's call the API and the example given below

REST API
API Endpoint (Sandbox/Test Environment): https://sandbox.sslcommerz.com/validator/api/v4/
API Endpoint (Live Environment): https://securepay.sslcommerz.com/validator/api/v4/
Method: POST

API Request

Param Name Data Type Description
store_id string (30) Mandatory - Your SSLCOMMERZ Store ID is the integration credential which can be collected through our managers
store_passwd string (30) Mandatory - Your SSLCOMMERZ Store Password is the integration credential which can be collected through our managers
refer string (30) Mandatory - This reference number you will get in SSLCOMMERZ panel. However for sandbox testing, you can use as "5B1F9DE4D82B6".
invoice_id string (50) Mandatory - This is a unique invoice id generated by SSLCOMMERZ Invoice System. You can use this inoivr id to check the payment status. Therefore, you may store this invoice id in your system.

API Response

Param Name Data Type Description
status string (10) API connectivity status. If all the required data is provided, then it will return as success, neither it will be failed
error_reason string (255) If API connectivity is failed then it returns the reason.
tran_date string (20) Transaction date of the payment. Example: 2020-08-25 10:10:10
tran_id string (30) The transaction ID has been shared at the time of payment.
val_id string (30) SSLCOMMERZ internal reference ID. You may store this id in your system.
amount decimal (10,2) The transaction amount. Example: 100.00
store_amount decimal (10,2) The net amount which will be settled to your bank account after deducting commission.
bank_tran_id string (30) The transaction ID from the bank end.
card_type string (50) Type of the card used for the transaction. Example: VISA-Bank Name
card_no string (20) Masked card number. Example: 411111XXXXXX1111
card_issuer string (50) Card issuing bank name.
card_brand string (20) Card brand name. Example: VISA, MASTER, AMEX, etc.
card_issuer_country string (50) Card issuing country.
card_issuer_country_code string (2) Card issuing country code.
currency_type string (3) The transaction currency. Example: BDT, USD, etc.
currency_amount decimal (10,2) The transaction amount in the currency type.
currency_rate decimal (10,4) The conversion rate of the currency to BDT.
base_fair decimal (10,2) The base fair of the transaction.
value_a string (255) Extra parameter to pass your meta data if it is needed.
value_b string (255) Extra parameter to pass your meta data if it is needed.
value_c string (255) Extra parameter to pass your meta data if it is needed.
value_d string (255) Extra parameter to pass your meta data if it is needed.