Overview
  • 28 Aug 2023
  • 2 Minutes to read
  • Contributors
  • Dark
    Light
  • PDF

Overview

  • Dark
    Light
  • PDF

Article summary

SmartLink is a service that helps you seamlessly convert regular, offline orders into online invoices without needing an e-commerce website.

Using Restful web services as a programming interface of SmartLink, you can generate invoices with payment links and inquire about your invoices.  Using the payment link the customer can proceed with the payment with a debit card, credit card, and many other payment options without exposing you to the cardholder's sensitive data. 

You can also generate reports for the reconciliation with the acquiring bank. 

This API documentation is intended for users who have signed up through SmartLink.

Manual mode provides a facility to the customers to provide the orders through phone. 

  1. Receive customer's order by phone and accordingly create an invoice using SmartLink portal.
  2. Send invoice summary and payment link via SMS and/or email to the customer.
  3. The customer needs to click the payment link to view invoice details, provide the card information to pay.
  4. Process the payment transaction in association with the acquirer.
  5. Notify the call center agent or sales team about the success of the payment via email. The agent can also check the SmartLink portal for updates.



Note: Contact Sales team <partnerships@payone.io > for more details about SmartLink Manual mode and to proceed with the registration.
  1. You generate an invoice CSV file and store it in a secure folder at your server. SmartLink will pull the CSV files through SFTP based on an agreed-upon interval.
  2. SmartLink sends invoice summary via SMS and/or email to the customer (including a smart link) and informs you about invoice generation by email.
  3. The customer needs to click the smart link to view invoice details, provide the card information to pay.
  4. SmartLink processes the payment transaction in association with the acquirer.
  5. SmartLink notifies your agent about the successful payment.


Integration Specifications

CSV File Parameters
  • Invoice ID
  • Customer unique ID
  • Customer mobile number
  • Customer email ID
  • Invoice amount and currency
  • Invoice description
  • Merchant employee email IDs (to be notified once the invoice is issued/ paid)
Optional Parameters
  • Payment link validity
  • Payment language
  • Preferred means of communication 
  • Invoice Type: to distinguish if the transaction on the invoice is payment or pre-Auth [if Merchant uses both transaction types] 
  • Extra Parameters: Custom fields (up to 4 fields, can be mutually agreed upon

Basic Integration Specifications

SFTP server authentication should have two-factor authentication as mentioned below:

  • username/password
  • client certificate

 SFTP Server should have three dedicated directories as mentioned below:

  • /PayOne/SmartLink/invoices/
  • /PayOne/SmartLink/Processed_invoices/
  • /PayOne/SmartLink/Failed_invoices/
Note: Contact Sales team <partnerships@payone.io > for more details about SmartLink Basic Integration mode and to proceed with the registration.

Integrated mode provides a facility to create invoices by integrating your system (For example - ERP, CRM) with SmartLink web services.

  1. Pull the customer’s outstanding amount(s) from your system. 
  2. Send invoice summary and payment link via SMS and/or email to the customer.
  3. The customer needs to open a payment link to view the invoice details and provide the card information to pay.
  4. Process the payment transaction in association with the acquirer. 
  5. Notify the merchant system about successful payments.



What's Next