Payment Links

How does the payment link work?

The payment link is a solution of the Payphone ecosystem that allows you to receive payments without a website, just by sending a link to your customers. If you want to sell through Facebook, Instagram, WhatsApp or email, the payment link is your solution.

It is also ideal for email wallet collections and asynchronous payments. The Payment Link can be generated from your PayPhone Business page or by doing a technological integration with our Api. Next we will show you how to generate a Payment Link from our Payphone Business page, and then with our Api if you need to make an integration with your system.

Payment Link Flow

The payment link works as follows:

Generate payment link with a specific receivable value.
Send payment link to customer.
Customer makes payment

Generate Payment Link from the portal Payphone Business

Enter your PayPhone Business portal with your Ruc, email and password, and go to the "Generate Payment Link" section.

Next enter the amount to be collected and press "Generate payment link".

A link will be automatically generated that you can share through the media of your preference, and additionally you will have a QR code (the person who scans it will open the payment link).

When your customer opens the link they can pay using their credit or debit card, or use their Payphone app to pay with gift cards or balance Payphone. The link looks like this:

Generate payment links through Api

The integration with the Api allows a more direct control over the transactions giving the facility to set maximum dates of use or limit its consumption to one time. With the Api consumption you can generate personalized links, for example, a school can generate a link for each student and have a direct control over tuition or pension payments and a better portfolio collection.

Follow the steps below to generate a link from our Api:

Business Requirements:

The establishment that is going to receive the payments must be registered in Payphone Business. To start the registration you can click here.
With the store active and ready to transact, you must create a "developer"type user, which we will explain later.

Development Requirements:

You must configure in our website for developers "Payphone Developer" your development environment where you can get all your authentication token with which you identify yourself in the services of Payphone.

Create developer user

Go to Payphone Business, and log in with your ruc, email and password, (if you do not have access, the company administrator can log in and create your user) and go to the "Users" section and then select "Create User":

Enter all the developer's data in the form, don't forget that in the "Roles" field you must enter "Developer". (The administrator must provide the e-mail address and password entered).

With this process ready, the user developer can start the implementation.

Page Payphone Developer

Configuring the development environment allows you to have full control over the transactions made through Payphone. Please follow the steps below:

1. Login as a developer

Go to https://appdeveloper.payphonetodoesposible.com/ and log in with your developer user credentials (Ruc, email and password).

2. Create Application Payphone:

The development applications Payphone allows you to configure your test environment, connection parameters or test users, and helps you to obtain your authentication credentials such as the token.

To create your application click on the "+" at the top:

A form will open where you must enter the fields of your application, the type of application must be API.

Press Save

Obtain authentication token

With the application configured you must click the top menu on the credentials tab, and you will have the button to copy your token...

Call for service

With the requirements ready, you must make a POST call indicating in the header your token of type "Authorization" with content "Bearer TUTOKEN". The call must be to the url: https://pay.payphonetodoesposible.com/api/Links with an object of type Json with the following parameters:

Name	Description	Data type	Optional
amount	Total value of the invoice receivable, is the sum of amountWithTax, amountWithoutTax, Tax, service and tip.	Int
amountWithoutTax	Value not taxed.	Int	X - only if VAT is charged, it is mandatory if no VAT is charged
amountWithTax	Taxable value, without tax included.	Int	X - only if values are charged without VAT, mandatory if values are charged with VAT.
tax	Value of the tax.	Int	X - only if values are charged without VAT, mandatory if values are charged with VAT.
service	Value of the service.	Int	X
tip	Value of the tip.	Int	X
currency	Currency receivable /e.g. USD	String	X
clientTransactionId	Transaction identifier, you must generate it, it is a unique identifier.	String
storeId	This parameter can be obtained in the "Company Request" section of the PayPhone Developer page, in the list button.	String	X
reference	Payment reference that you can send.	String	X
oneTime	Field to control if the link works only once: True if the link is used only once, false if it is used several times.	Boolean	X
expireIn	Number of hours the payment link will be available.	Integer	X

Examples of Json method links:

Generate $1.12 payment link, where $1 dollar is the subtotal and $0.12 is the tax:

				
					{
"amount": 112,
"tax": 12,
"amountWithTax": 100,
"clientTransactionId": "idlink001",
"currency": "USD"
}

Generate a payment link for $1.00 tax free.

				
					{
"amount": 100,
"amountWithoutTax": 100,
"clientTransactionId": "idlink001",
"currency": "USD"
}

These are the base objects but we recommend that you send as much data as possible so that you have better control.

The response of the POST request of the LINKS method is the url containing the payment link.

That's it, those are all the steps to generate paid links. Remember that with the Api you can only consume up to 20 times per minute.

Did you know that...