Pay by link

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

The Pay by link is a feature available both through the Partner 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 Partner portal of Scalapay

Thanks to the Pay by link, the merchant can send his 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 Partner portal.

How it works

  1. Log in to your Scalapay Partner 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 appears in the list of the Pay by link orders in Pending status.



📘

Important

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.

Do you want to send the link to pay for the order to the customer's mobile phone?

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

The link will be available in the Pay by link section. 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 on 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 back-end.

Pay by link API at a glance:

  • REST API
  • POST call

How it works

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 parameter.

AttributeTypeAccepted values
industryobjectThe only accepted values is industry
travelobjectThe only accepted value is travel
startDatedateYYYY-MM-DD
endDatedateYYYY-MM-DD

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"]
                }
            }
        }
    }
}