Link do Płatności umożliwia akceptowanie płatności za pomocą unikalnego linku, który można udostępniać klientom. Możesz szybko dostosowywać, tworzyć, zarządzać i udostępniać linki do płatności za pośrednictwem różnych kanałów, takich jak e-mail, media społecznościowe i wiadomości tekstowe.

Po kliknięciu linku Klient zostaje przekierowany na stronę płatności zawierającą Formularz płatności. Po zakończeniu płatności otrzymasz powiadomienie za pośrednictwem webhooka, jeśli został on wcześniej skonfigurowany.

Usługa ta usprawnia akceptację płatności dla firm każdej wielkości.

Metody płatności

Krok 1: Dostosuj stronę docelową

Zanim zaczniesz korzystać z Linku do Płatności, dostosuj w SIBS Backoffice stronę docelową płatności.

1. Przejdź do SIBS Backoffice i znajdź SIBS Payment Gateway > Link do płatności w menu po lewej stronie. Kliknij przycisk Dostosuj stronę docelową.
2. Dodaj nazwę szablonu, wybierz temat, język i prześlij swoje logo. Następnie kliknij Zapisz.

Krok 2: Utwórz link do płatności

Opcja 1: Utwórz nowy link w SIBS Backoffice

Opcja 2: Utwórz nowy link przez API

Opcja 1: Utwórz nowy link w SIBS Backoffice

W menu Link do płatności w SIBS Backoffice możesz utworzyć nowy link do płatności, wybierając przycisk „Utwórz nowy link”. Ta akcja powoduje, że interfejs wygeneruje i zapisze nowy link do płatności wraz z powiązanymi informacjami.

Generując nowy link, musisz wypełnić dwie istotne sekcje na tej stronie:

Opcja 2: Utwórz nowy link przez API

Use the following endpoint to create new links via API and share with your customers:

Environment	URL	Operation Method & Endpoint	Operation Description
PROD	api.sibsgateway.com	POST /api/v1/link-to-pay/create	Performs a request to create a link
CER	stargate-cer.qly.site1.sibs.pt	/api/v1/link-to-pay/create	Performs a request to create a link

Please check below the API structure request to create a new link:

New Link request

Location	Data Element	Type	Condition	Description
Request Header	Content-Type	String	Mandatory	application/json
Request Header	Authorization	String	Mandatory	Bearer Token. Based on OAuth2 authentication performed in a pre-step
Request Header	x-ibm-client-id	String	Mandatory	Token that identifies a client organization. It is provided during onboarding process and must be used in every call.
Request Body.paymentInfo.paymentMethods	paymentMethod	PaymentMethodCode	Conditional	Payment method code. Possible values : • CARD-‘Card Payments’ • PYBL-‘Pay By Link’ • BLIK-‘BLIK’ • XPAY-‘XPAY Payments’ • BNCT-‘Bancontact’ • IDEL-‘Ideal’ Condition: at least one payment method must be selected. Max5Text
Request Body.paymentInfo.amount	Value	Number (double)	Mandatory	Amount in the transaction.
Request Body.paymentInfo.amount	currency	Currency Code	Mandatory	Currency used in the transaction. ISO 4217 Alpha-3 Code.
Request Body.paymentInfo	merchant-id	String	Mandatory	Merchant code Max10NumericText
Request Body.paymentInfo	acceptorId	String	Mandatory	Acceptor code in Merchant Max10NumericText
Request Body.paymentInfo	terminalId	String	Mandatory	Terminal code. Max10NumericText
Request Body.paymentInfo	amount	Amount	Mandatory	Amount with the value and currency of the transaction.
Request Body.paymentInfo	validity	ValidityTypeCode	Mandatory	Validity type code. Possible values: • HR48 – 48 hours; • HR72 – 72 hours; • DY90 – 90 days. Exact4Text
Request Body.paymentInfo	linkType	LinkTypeCode	Mandatory	Link type code. Possible values: • SNGL – single usage • MLTP – multiple usage Exact4Text
Request Body.paymentInfo	paymentMethods	PaymentMethods	Mandatory	Array of Allowed Payment Methods
Request Body.paymentInfo	reference	String	Mandatory	Reference related to link Max35Text
Request Body.paymentInfo	description	String	Mandatory	Description related to link Max256Text
Request Body.dataCollection.shippingAddress	shippingAddressCollection	Boolean	Mandatory	Indicates if Shipping Address must be collected.
Request Body.dataCollection.shippingAddress	shippingCityCollection	Boolean	Mandatory	Indicates if Shipping Address City must be collected.
Request Body.dataCollection.shippingAddress	shippingPostalCodeCollection	Boolean	Mandatory	Indicates if Shipping Address Postal Code must be collected.
Request Body.dataCollection.shippingAddress	shippingCountryCollection	Boolean	Mandatory	Indicates if Shipping Address Country must be collected.
Request Body.dataCollection.customMerchantInfo.parameters.parameter	tag	String	Mandatory	Reference related to link (regarding Link to Pay service) Max35Text
Request Body.dataCollection.customerInfo	customerName	Boolean	Mandatory	Indicator related to “customer name”: • True – field to be collected from customer; • False – filed to not be present to customer (not necessary to be collected from customer). Must be filled with “True “
Request Body.dataCollection.customerInfo	customerEmail	Boolean	Mandatory	Indicator related to “customer email”: True – field to be collected from customer; False – filed to not be present to customer (not necessary to be collected from customer). Must be filled with “True”
Request Body.dataCollection.billingAddress	billingAddressCollection	Boolean	Mandatory	Indicates if Billing Address must be collected.
Request Body.dataCollection.billingAddress	billingCityCollection	Boolean	Mandatory	Indicates if Billing Address City must be collected.
Request Body.dataCollection.billingAddress	billingCountryCollection	Boolean	Mandatory	Indicates if Billing Address Country must be collected.
Request Body.dataCollection,billingAddress	billingPostalCodeCollection	Boolean	Mandatory	Indicates if Billing Address Postal Code must be collected.
Request Body.dataCollection	customerInfo	CustomerInfo	Mandatory	Object that set customer information to be collected.
Request Body.dataCollection	billingAddress Info	BillingAddress	Mandatory	Object that set billing address information to be collected.
Request Body.dataCollection	shippingAddressInfo	ShippingAddress	Mandatory	Object that set shipping address information to be collected.
Request Body.dataCollection	customMerchantInfo	CustomMerchantInfo	Optional	Object that set specific merchant information to be collected.
Request Body	paymentInfo	PaymentInfo	Mandatory	Object that defines payment info related to link generation.
Request Body	dataCollection	DataCollection	Mandatory	Object that identifies info to be collected from the customer.

New Link request example

{
  "paymentInfo" : {
    "merchantId" : "530",
    "acceptorId" : "1",
    "terminalId" : "450",
    "amount" : {
      "value" : 4,
      "currency" : "PLN"
    },
    "validity" : "DY90",
    "linkType" : "SNGL",
    "paymentMethods" : ["BLIK"],
    "reference" : "4",
    "description" : "Test 4"
  },
  "dataCollection" : {
    "customerInfo" : {
      "customerName" : true,
      "customerEmail" : true
    },
    "billingAddressInfo" : {
      "billingAddressCollection" : false,
      "billingCityCollection" : false,
      "billingPostalCodeCollection" : false,
      "billingCountryCollection" : false
    },
    "shippingAddressInfo" : {
      "shippingAddressCollection" : false,
      "shippingCityCollection" : false,
      "shippingPostalCodeCollection" : false,
      "shippingCountryCollection" : false
    },
    "customMerchantInfo" : {
      "parameters" : {
        "tag" : "t1",
        "label" : "tag",
        "format" : "jpg"
      }
    }
  }
}

The response from the new Link creation operation is the following:

Response example

{
   "linkId": "N2RjMzZiNGMtNDljZC00NTkyLTllYWEtMGE",
   "linkURL": "https://www.linkURL.com/linktopay//N2RjMzZiNGMtNDljZC00NTkyLTllYWEtMGE.MjAyNS0wMS0yNiAxNjowMToyMC4wMDE=.Tn4XoWV86LBSm5ndLvYm+5S/jliipSoFs9u0ywoq3QY=",
   "linkExpiryDate": "2025-01-26T16:01:20.955Z",
   "returnStatus":    {
      "statusCode": "000",
      "statusMsg": "Success",
      "statusDescription": "Success"
   }
}

Okres ważności i użycie linku

Korzystając z Link to Pay, możesz skonfigurować okres ważności linku, od 48 godzin, 72 godzin lub maksymalnie 90 dni.

Dodatkowo masz możliwość ustawienia linku do płatności do jednorazowego lub wielokrotnego użycia. W przypadku jednorazowego użytku, link przeznaczony jest na jedną udaną transakcję, natomiast w przypadku wielokrotnego użytku można go udostępnić wielu kupującym bez żadnych ograniczeń.

Zarządzaj linkami do płatności

W menu Link to Pay w SIBS Backoffice znajdziesz listę wszystkich wygenerowanych linków.

Menu zawiera następujące informacje:

Kategoria	Opis
Link ID	Unikalny identyfikator generowany w momencie utworzenia linku.
Opis	Opis linku.
Data utworzenia linku	Data i godzina utworzenia linku.
Data wygaśnięcia linku	Data i godzina wygaśnięcia linku.
Status	Wskazuje status linku do płatności: ’Aktywny’ Link do płatności, który nie został wykorzystany, nowo utworzony lub reaktywowany przez sprzedawcę, i którego bieżąca data i godzina przypada przed ustaloną datą wygaśnięcia. Klient może go użyć do dokonania płatności. ’Nieaktywny’ Jednorazowy link do płatności, który został użyty. Nie może on być wykorzystany przez klienta do dokonania kolejnych płatności. „Anulowany”: Link do płatności, który został anulowany przez sprzedawcę. Nie można go już użyć. ’Wygasły’ Link do płatności, którego aktualna data i godzina jest późniejsza niż Data Wygaśnięcia ustawiona podczas utworzenia linku. Nie można go już użyć. ’Dezaktywowany’ Link do płatności, który został dezaktywowany przez sprzedawcę i nie umożliwia dokonywania płatności. Sprzedawca może go ponownie aktywować, jeśli Data Wygaśnięcia nie została przekroczona. ’Wstrzymany’ Transakcja wykonana za pomocą linku płatniczego oczekuje na realizację. Nie można go użyć.

Możesz rozwinąć wybrany wiersz i zobaczyć więcej szczegółów dotyczących wybranego linka.

Jeśli klikniesz ikonę trzech kropek, możesz mieć do dyspozycji następujące działania:

• Kopiuj Link – umożliwia szybkie skopiowanie linka w celu udostępnienia.

• Dezaktywuj Link Tymczasowo zawiesza link. Można go reaktywować.
• Anuluj Link – trwale unieważnia link. Nie można go ponownie aktywować.
• Aktywuj Link – ponownie aktywuje wcześniej dezaktywowany link.
• Associated Transactions – przekierowuje do menu Transakcje w SIBS Backoffice, gdzie znajdziesz listę wszystkich transakcji z ostatnich 7 dni powiązanych z wybranym linkiem do płatności.