The Pay by link gives the merchant the possibility to send their customers a link via SMS and via e-mail to pay in instalments with Scalapay.

The Pay by link is a feature available both through the Merchant Portal of Scalapay and through the use of API calls in case of a custom integration.

The link is valid for 24 hours: the customer can complete the order within this time frame.

Pay by link via the Merchant Portal of Scalapay

Thanks to the Pay by link, the merchant can send their customers a link via SMS or via e-mail to pay with Scalapay.

The link is valid for 24 hours. Once the order has been paid, the order status is updated in the Merchant Portal.

Here are the steps to follow to create a Pay by link through the Merchant Portal of Scalapay.

1. Log in to your Scalapay Merchant Portal.
2. Go to the Pay by link section on the left side menu.
3. Click on Create order.
4. Fill out the Pay by link form and click on Create Order. The created order will appear in the list of the Pay by link orders in Pending status.

📘

Order ID field

The Order ID field is important for the reconciliation. The merchant can fill this field with his order reference.

The merchant can decide whether to send the link automatically to the customer's phone number or to send it in another moment.

You can send the link to pay for the order to the customer's mobile number.

If the option chosen is Not send, the payment link will be created in the Merchant Portal but not sent to the customer.

The link will be available in the Pay by link section. In order to use it, the merchant will have to select the link and click on Send link.

Pay by link custom

The merchant can integrate the Pay by link functionality into his system using the Pay by link API calls: he will be able to send the payment link to the customers via SMS and e-mail directly from his backend.

Pay by link API at a glance:

• REST API
• POST call

Here are the steps to follow to create a Pay by link custom.

The Pay by link API documentation is available at this link.

As a Travel merchant, it is mandatory to add the following fields in the Extensions parameters.

Please find below a full example of the Pay by link API for Travel merchants.

{
    "totalAmount": {
        "amount": "1500.00",
        "currency": "EUR"
    },
    "consumer": {
        "phoneNumber": "0400000001",
        "givenNames": "Joe",
        "surname": "Consumer",
        "email": "[email protected]"
    },
    "billing": {
        "name": "Joe Consumer",
        "line1": "Via della Rosa, 58",
        "suburb": "Montelupo Fiorentino",
        "postcode": "50056",
        "countryCode": "IT",
        "phoneNumber": "0400000000"
    },
    "shipping": {},
    "items": [
        {
            "name": "Tours Islands",
            "category": "Honeymoon Trips",
            "brand": "Tour Operator Name",
            "sku": "12341234",
            "quantity": 1,
            "price": {
                "amount": "1500.00",
                "currency": "EUR"
            }
        }
    ],
    "discounts": [
        {
            "displayName": "10% Off",
            "amount": {
                "amount": "150.00",
                "currency": "EUR"
            }
        }
    ],
    "merchant": {
        "redirectConfirmUrl": "https://scalapay.com",
        "redirectCancelUrl": "https://scalapay.com"
    },
    "merchantReference": "merchantOrder-1234",
    "taxAmount": {
        "amount": "3.70",
        "currency": "EUR"
    },
    "shippingAmount": {
        "amount": "10.00",
        "currency": "EUR"
    },
    "orderExpiryMilliseconds": 6000000,
    "channel": "scalapay.com",
    "type": "link",
    "product": "pay-in-3",
    "frequency": {
        "number": 1,
        "frequencyType": "monthly"
    },
    "extensions": {
        "industry": {
            "travel": {
                "startDate": "2023-11-30",
                "endDate": "2023-12-07"
            }
        },
        "type": {
            "link": {
                "notification": {
                    "phoneCountryCode": "+39",
                    "phoneNumber": "3491865100",
                    "preferredLanguage": "italiano",
                    "channels": ["sms"]
                }
            }
        }
    }
}