Login

  • Pagasubito
  • POST Pay

Generate a form

This method allows you to generate an html form that auto-submits to get to Paytipper, the real payment manager.

Resource

Production environment:

  • https://ws.pagasubito.it/pay/"type"

Testing environment

  • https://test.ws.pagasubito.it/pay/"type"

Types allowed

Property name Type Required Description
123 string yes Generic white postal payment slip.
451 string yes Personalized white postal payment slip.
674 string yes Partially pre-labeled postal payment slip.
896 string yes Pre-labeled postal payment slip.
mav string yes Payment by notice.
rav string yes Role by notice.
pagopa string yes Public administration payment.
bolloauto string yes Car tax.

123 - 451 Parameters

Property name Type Required Description
email string yes Payer email.
cognome string no Payer surname.
nome string no Payer name.
indirizzo string no Payer address.
cap string no Payer postal code.
localita string no Payer city.
provincia string no Payer province.
telefono string no Payer telephone.
ccp string yes Postal account.
causale string yes Reason for payment.
importo string yes Amount to be paid formatted to two decimal places after the dot: 15.00.

674 - 896 Parameters

Property name Type Required Description
email string yes Payer email.
cognome string no Payer surname.
nome string no Payer name.
indirizzo string no Payer address.
cap string no Payer postal code.
localita string no Payer city.
provincia string no Payer province.
telefono string no Payer telephone.
ccp string yes Postal account.
codice_bollettino string yes Bulletin code.
importo string yes Amount to be paid formatted to two decimal places after the dot: 15.00.

Mav - Rav Parameters

Property name Type Required Description
email string yes Payer email.
telefono string no Payer telephone.
codice_mav string yes* Mav code.
codice_rav string yes* Rav code.
importo string yes Amount to be paid formatted to two decimal places after the dot: 15.00.

Pagopa Parameters

Property name Type Required Description
email string yes Payer email.
cognome string no Payer surname.
nome string no Payer name.
telefono string no Payer telephone.
ente_pa string yes Creditor code.
avviso_pa string yes Notice number.

Bolloauto Parameters

Property name Type Required Description
email string yes Payer email.
cognome string no Payer surname.
nome string no Payer name.
telefono string no Payer telephone.
tipo_veicolo string yes Vehicle type; accepted values: 1 for car; 2 for trailer; 4 for motorcycle.
targa string yes License plate.

Request examples

Response

Response Format

If successful, the response header HTTP status code will be 200 OK and the request will be answered.

If you try to get a request without authorization, you will receive an error 401 Unauthorized.

Additionally you should also handle the 400 Bad request status. For more info on HTTP status handling see dedicated section in Integration best practices page.

Request Response

Parameter Type Description
data DataResponseDetails Present only if the API call goes to good end, it will contain the answer data.
success boolean True or false.
message string It contains a message that can be shown by the user.
error int Present only if the API call fails, it contains an error code.

Data Response Details

Parameter Type Description
Html Form string It contains the form with the data and a script that auto-submits everything towards the Paytipper payment page. Just make an "echo" of this form on your page to be redirected.