DevPortalPagoPA

SoluzioniWebinar
Tabella dei contenuti

Primitive

Per la gestione degli errori fare riferimento a Gestione degli errori.
Per i dettagli https://github.com/pagopa/pagopa-api/tree/SANP3.2.1

Parametri

body
idPA *
codice fiscale della struttura che invia la richiesta di pagamento
body
idBrokerPA *
identificativo del soggetto che opera come intermediario per l'EC
body
idStation *
identificativo della stazione dell'EC nel sistema pagoPa
body
qrCode *
è composto da
fiscalCode
e
noticeNumber
body
fiscalCode *
codice fiscale dell'EC
body
noticeNumber *
[auxDigit][segregationCode][IUVBase][IUVCheckDigit]
1  <soapenv:Envelope>
2    <soapenv:Header />
3    <soapenv:Body>
4      <nod:paVerifyPaymentNoticeReq>
5        <idPA>77777777777</idPA>
6        <idBrokerPA>77777777777</idBrokerPA>
7        <idStation>77777777777_01</idStation>
8        <qrCode>
9          <fiscalCode>77777777777</fiscalCode>
10          <noticeNumber>311111111112222222</noticeNumber>
11        </qrCode>
12      </nod:paVerifyPaymentNoticeReq>
13    </soapenv:Body>
14  </soapenv:Envelope>
15

paGetPayment

Parametri

body
idPA *
Codice fiscale della struttura che invia la richiesta di pagamento.
body
idBrokerPA *
Identificativo del soggetto che opera come intermediario per l'EC.
body
idStation *
Identificativo della stazione dell'EC nel sistema pagoPa.
body
qrCode *
E' composto da
fiscalCode
e
noticeNumber.
body
fiscalCode *
Codice fiscale dell'EC.
body
noticeNumber *
[auxDigit][segregationCode][IUVBase][IUVCheckDigit]
body
amount
Importo del pagamento in euro.
body
paymentNote
Descrizione del pagamento.
body
transferType
Valore ammesso: POSTAL.
body
dueDate
Data di scadenza del pagamento secondo il formato ISO 8601 [AAAA]-[MM]-[GG].
1<soapenv:Envelope>
2    <soapenv:Body>
3      <pafn:paGetPaymentReq>
4        <idPA>77777777777</idPA>
5        <idBrokerPA>77777777777</idBrokerPA>
6        <idStation>77777777777_01</idStation>
7        <qrCode>
8          <fiscalCode>77777777777</fiscalCode>
9          <noticeNumber>311111111112222222</noticeNumber>
10        </qrCode>
11        <amount>30.00</amount>
12      </pafn:paGetPaymentReq>
13    </soapenv:Body>
14  </soapenv:Envelope>    
15

Parametri

**In questa versione è possibile inserire i metadata in ogni singolo **
transfer
, inoltre è possibile gestire il servizio @e.bollo.
body
idPA *
Codice fiscale della struttura che invia la richiesta di pagamento.
body
idBrokerPA *
Identificativo del soggetto che opera come intermediario per l'EC.
body
idStation *
Identificativo della stazione dell'EC nel sistema pagoPa.
body
qrCode *
E' composto da
fiscalCode
e
noticeNumber.
body
fiscalCode *
codice fiscale dell'EC
body
noticeNumber *
[auxDigit][segregationCode][IUVBase][IUVCheckDigit]
body
amount *
importo del pagamento in euro
body
paymentNote
descrizione del pagamento
body
transferType
valore ammesso: POSTAL
body
dueDate
data di scadenza del pagamento secondo il formato ISO 8601 [AAAA]-[MM]-[GG]
1<soapenv:Envelope>
2    <soapenv:Body>
3      <pafn:paGetPaymentReq>
4        <idPA>77777777777</idPA>
5        <idBrokerPA>77777777777</idBrokerPA>
6        <idStation>77777777777_01</idStation>
7        <qrCode>
8          <fiscalCode>77777777777</fiscalCode>
9          <noticeNumber>311111111112222222</noticeNumber>
10        </qrCode>
11        <amount>30.00</amount>
12      </pafn:paGetPaymentReq>
13    </soapenv:Body>
14  </soapenv:Envelope>         
15

paSendRT

Parametri

body
idPA *
codice fiscale della struttura che invia la richiesta di pagamento
body
idBrokerPA *
identificativo del soggetto che opera come intermediario per l'EC
body
idStation *
identificativo della stazione dell'EC nel sistema pagoPa
body
receipt *
la ricevuta di pagamento
body
outcome *
il risultato dell'operazione che può contenere i codici OK o KO
body
receiptId *
identificatore univoco della
receipt
contiene il
paymentToken
assegnato da pagoPa
body
noticeNumber *
[auxDigit][segregationCode][IUVBase][IUVCheckDigit]
body
fiscalCode *
codice fiscale dell'EC
body
creditorReferenceId *
IUV
Identificativo Univoco Versamento
body
paymentAmount *
importo espresso in euro
body
description *
body
companyName *
nome completo dell'EC
body
officeName
body
debtor *
individua il debitore a cui si riferisce la posizione debitoria
body
uniqueIdentifier *
body
entityUniqueIdentifierType *
F : Persona fisica
G : Persona giuridica
body
entityUniqueIdentifierValue *
codice fiscale o partita IVA
body
fullName *
nome completo del debitore
body
streetName
body
civicNumber
body
postalCode
body
city
body
stateProvinceRegion
body
country
body
e-mail
body
transferList *
struttura che contiene i dettagli dei
transfer
body
transfer *
body
idTransfer *
indice della lista (da 1 a 5)
body
transferAmount *
importo
body
fiscalCodePA *
codice fiscale dell'EC
body
IBAN *
IBAN sul quale sarà effettuato il riversamento
body
remittanceInformation *
motivo del pagamento
body
transferCategory *
codice tassonomico, composto da
Codice tipo Ente Creditore + Progressivo macro area + Codice tipologia servizio + Motivo Giuridico
( ex.
0101002IM
)
body
idPSP *
identificativo del PSP
body
pspFiscalCode
body
pspPartitaIVA
body
PSPCompanyName *
body
idChannel *
body
channelDescription *
body
payer
individua il pagatore
body
uniqueIdentifier *
body
entityUniqueIdentifierType *
F : Persona fisica
G : Persona giuridica
body
entityUniqueIdentifierValue *
codice fiscale o partita IVA
body
fullName *
nome completo del debitore
body
streetName
body
civicNumber
body
postalCode
body
city
body
stateProvinceRegion
body
country
body
e-mail
body
paymentMethod
body
fee
importo della commissione espresso in euro
body
paymentDateTime
data e ora del pagamento
body
applicationDate
data applicativa
body
transferDate
data del riversamento
body
metadata
body
mapEntry *
body
key *
body
value *
1  <soapenv:Envelope>
2    <soapenv:Body>
3      <pafn:paSendRTReq>
4        <idPA>77777777777</idPA>
5        <idBrokerPA>77777777777</idBrokerPA>
6        <idStation>77777777777_01</idStation>
7        <receipt>
8          <receiptId>c110729d258c4ab1b765fe902aae41d6</receiptId>
9          <noticeNumber>311111111112222222</noticeNumber>
10          <fiscalCode>77777777777</fiscalCode>
11          <outcome>OK</outcome>
12          <creditorReferenceId>11111111112222222</creditorReferenceId>
13          <paymentAmount>30.00</paymentAmount>
14          <description>test</description>
15          <companyName>company EC</companyName>
16          <officeName>office EC</officeName>
17          <debtor>
18            <uniqueIdentifier>
19              <entityUniqueIdentifierType>F</entityUniqueIdentifierType>
20              <entityUniqueIdentifierValue>JHNDOE00A01F205N</entityUniqueIdentifierValue>
21            </uniqueIdentifier>
22            <fullName>John Doe</fullName>
23            <streetName>street</streetName>
24            <civicNumber>12</civicNumber>
25            <postalCode>89020</postalCode>
26            <city>city</city>
27            <stateProvinceRegion>MI</stateProvinceRegion>
28            <country>IT</country>
29            <e-mail>john.doe@test.it</e-mail>
30          </debtor>
31          <transferList>
32            <transfer>
33              <idTransfer>1</idTransfer>
34              <transferAmount>20.00</transferAmount>
35              <fiscalCodePA>77777777777</fiscalCodePA>
36              <IBAN>IT0000000000000000000000000</IBAN>
37              <remittanceInformation>remittanceInformation1</remittanceInformation>
38              <transferCategory>0101100IM</transferCategory>
39            </transfer>
40            <transfer>
41              <idTransfer>2</idTransfer>
42              <transferAmount>10.00</transferAmount>
43              <fiscalCodePA>77777777778</fiscalCodePA>
44              <IBAN>IT0000000000000000000000001</IBAN>
45              <remittanceInformation>remittanceInformation2</remittanceInformation>
46              <transferCategory>0201102IM</transferCategory>
47            </transfer>
48          </transferList>
49          <idPSP>88888888888</idPSP>
50          <pspFiscalCode>88888888888</pspFiscalCode>
51          <pspPartitaIVA>88888888888</pspPartitaIVA>
52          <PSPCompanyName>PSP name</PSPCompanyName>
53          <idChannel>88888888888_01</idChannel>
54          <channelDescription>app</channelDescription>
55          <payer>
56            <uniqueIdentifier>
57              <entityUniqueIdentifierType>F</entityUniqueIdentifierType>
58              <entityUniqueIdentifierValue>JHNDOE00A01F205N</entityUniqueIdentifierValue>
59            </uniqueIdentifier>
60            <fullName>John Doe</fullName>
61            <streetName>street</streetName>
62            <civicNumber>12</civicNumber>
63            <postalCode>89020</postalCode>
64            <city>city</city>
65            <stateProvinceRegion>MI</stateProvinceRegion>
66            <country>IT</country>
67            <e-mail>john.doe@test.it</e-mail>
68          </payer>
69          <paymentMethod>creditCard</paymentMethod>
70          <fee>2.00</fee>
71          <paymentDateTime>2021-10-01T17:48:22</paymentDateTime>
72          <applicationDate>2021-10-01</applicationDate>
73          <transferDate>2021-10-02</transferDate>
74          <metadata>
75            <mapEntry>
76              <key>keytest</key>
77              <value>1</value>
78            </mapEntry>
79          </metadata>
80        </receipt>
81      </pafn:paSendRTReq>
82    </soapenv:Body>
83  </soapenv:Envelope>
84

Parametri

**In questa versione possono essere inseriti i metadata in ogni singolo **
transfer
** della **
receipt,
** inoltre sono gestite le informazioni ricavate da**
Gestione evoluta commissioni
e il servizio @e.bollo.
body
idPA *
codice fiscale della struttura che invia la richiesta di pagamento
body
idBrokerPA *
identificativo del soggetto che opera come intermediario per l'EC
body
idStation *
identificativo della stazione dell'EC nel sistema pagoPa
body
receipt *
la ricevuta di pagamento
body
outcome *
il risultato dell'operazione che può contenere i codici OK o KO
body
receiptId *
identificatore univoco della
receipt
contiene il
paymentToken
assegnato da pagoPa
body
noticeNumber *
[auxDigit][segregationCode][IUVBase][IUVCheckDigit]
body
fiscalCode *
codice fiscale dell'EC
body
creditorReferenceId *
IUV
Identificativo Univoco Versamento
body
paymentAmount *
importo espresso in euro
body
description *
body
companyName *
nome completo dell'EC
body
officeName
body
debtor *
individua il debitore a cui si riferisce la posizione debitoria
body
uniqueIdentifier *
body
entityUniqueIdentifierType *
F : Persona fisica
G : Persona giuridica
body
entityUniqueIdentifierValue *
codice fiscale o partita IVA
body
fullName *
nome completo del debitore
body
streetName
body
civicNumber
body
postalCode
body
city
body
stateProvinceRegion
body
country
body
e-mail
body
transferList *
struttura che contiene i dettagli dei
transfer
body
transfer *
body
idTransfer *
indice della lista (da 1 a 5)
body
transferAmount *
importo
body
fiscalCodePA *
codice fiscale dell'EC
body
CHOICE *
Choice tra IBAN e marcaDaBollo
body
IBAN *
IBAN sul quale sarà effettuato il riversamento
body
marcaDaBollo
I dati della marca da bollo digitale
body
tipoBollo
Tipologia del bollo
body
MBDAttachment
Il documento XML che contiene la marca da bollo digitale, nel formato base64.
body
remittanceInformation *
motivo del pagamento
body
transferCategory *
codice tassonomico, composto da
Codice tipo Ente Creditore + Progressivo macro area + Codice tipologia servizio + Motivo Giuridico
( ex.
0101002IM
)
body
metadata
body
mapEntry
body
key
body
value
body
idPSP *
identificativo del PSP
body
pspFiscalCode
body
pspPartitaIVA
body
PSPCompanyName *
body
idChannel *
body
channelDescription *
body
payer
individua il pagatore
body
uniqueIdentifier *
body
entityUniqueIdentifierType *
F : Persona fisica
G : Persona giuridica
body
entityUniqueIdentifierValue *
codice fiscale o partita IVA
body
fullName *
nome completo del debitore
body
streetName
body
civicNumber
body
postalCode
body
city
body
stateProvinceRegion
body
country
body
e-mail
body
paymentMethod
body
fee
importo della commissione espresso in euro
body
primaryCiIncurredFee
importo della commissione a carico dell'EC espresso in euro ricavato da
Gestione evoluta commissioni
body
idBundle
identificativo del pacchetto di
Gestione evoluta commissioni
body
idCiBundle
identificativo degli attributi aggiunti dall'EC al pacchetto di
Gestione evoluta commissioni
body
paymentDateTime
data e ora del pagamento
body
applicationDate
data applicativa
body
transferDate
data del riversamento
body
metadata
body
mapEntry *
body
key *
body
value *
1  <soapenv:Envelope>
2    <soapenv:Body>
3      <pafn:paSendRTReq>
4        <idPA>77777777777</idPA>
5        <idBrokerPA>77777777777</idBrokerPA>
6        <idStation>77777777777_01</idStation>
7        <receipt>
8          <receiptId>c110729d258c4ab1b765fe902aae41d6</receiptId>
9          <noticeNumber>311111111112222222</noticeNumber>
10          <fiscalCode>77777777777</fiscalCode>
11          <outcome>OK</outcome>
12          <creditorReferenceId>11111111112222222</creditorReferenceId>
13          <paymentAmount>30.00</paymentAmount>
14          <description>test</description>
15          <companyName>company EC</companyName>
16          <officeName>office EC</officeName>
17          <debtor>
18            <uniqueIdentifier>
19              <entityUniqueIdentifierType>F</entityUniqueIdentifierType>
20              <entityUniqueIdentifierValue>JHNDOE00A01F205N</entityUniqueIdentifierValue>
21            </uniqueIdentifier>
22            <fullName>John Doe</fullName>
23            <streetName>street</streetName>
24            <civicNumber>12</civicNumber>
25            <postalCode>89020</postalCode>
26            <city>city</city>
27            <stateProvinceRegion>MI</stateProvinceRegion>
28            <country>IT</country>
29            <e-mail>john.doe@test.it</e-mail>
30          </debtor>
31          <transferList>
32            <transfer>
33              <idTransfer>1</idTransfer>
34              <transferAmount>20.00</transferAmount>
35              <fiscalCodePA>77777777777</fiscalCodePA>
36              <IBAN>IT0000000000000000000000000</IBAN>
37              <remittanceInformation>remittanceInformation1</remittanceInformation>
38              <transferCategory>0101100IM</transferCategory>
39              <metadata>
40                <mapEntry>
41                  <key>keytest</key>
42                  <value>1</value>
43                </mapEntry>
44              </metadata>            
45            </transfer>
46            <transfer>
47              <idTransfer>2</idTransfer>
48              <transferAmount>10.00</transferAmount>
49              <fiscalCodePA>77777777778</fiscalCodePA>
50              <IBAN>IT0000000000000000000000001</IBAN>
51              <remittanceInformation>remittanceInformation2</remittanceInformation>
52              <transferCategory>0201102IM</transferCategory>
53            </transfer>
54          </transferList>
55          <idPSP>88888888888</idPSP>
56          <pspFiscalCode>88888888888</pspFiscalCode>
57          <pspPartitaIVA>88888888888</pspPartitaIVA>
58          <PSPCompanyName>PSP name</PSPCompanyName>
59          <idChannel>88888888888_01</idChannel>
60          <channelDescription>app</channelDescription>
61          <payer>
62            <uniqueIdentifier>
63              <entityUniqueIdentifierType>F</entityUniqueIdentifierType>
64              <entityUniqueIdentifierValue>JHNDOE00A01F205N</entityUniqueIdentifierValue>
65            </uniqueIdentifier>
66            <fullName>John Doe</fullName>
67            <streetName>street</streetName>
68            <civicNumber>12</civicNumber>
69            <postalCode>89020</postalCode>
70            <city>city</city>
71            <stateProvinceRegion>MI</stateProvinceRegion>
72            <country>IT</country>
73            <e-mail>john.doe@test.it</e-mail>
74          </payer>
75          <paymentMethod>creditCard</paymentMethod>
76          <fee>2.00</fee>
77          <primaryCiIncurredFee>0.50</primaryCiIncurredFee>
78          <idBundle>1</idBundle>
79          <idCiBundle>2</idCiBundle>
80          <paymentDateTime>2021-10-01T17:48:22</paymentDateTime>
81          <applicationDate>2021-10-01</applicationDate>
82          <transferDate>2021-10-02</transferDate>
83          <metadata>
84            <mapEntry>
85              <key>keytest</key>
86              <value>1</value>
87            </mapEntry>
88          </metadata>
89        </receipt>
90      </pafn:paSendRTReq>
91    </soapenv:Body>
92  </soapenv:Envelope>
93

Parametri

body
idPSP *
Identificativo del PSP, assegnato da PagoPA.
Il codice è generalmente rappresentato dal codice BIC (Bank Identifier Code) del PSP.
In assenza del codice BIC, o per gestire situazioni particolari, può essere utilizzato un altro codice, purché identifichi in modo univoco il PSP.
body
idBrokerPSP *
Identificativo dell'intermediario, assegnato da PagoPA.
Identificazione dell'intermediario/broker del PSP che fornisce l'accesso (canale) al PSP per l'erogazione del servizio.
Nota: l'intermediario/broker può coincidere con il PSP stesso.
body
idChannel *
Identificativo del canale, identifica una categoria di servizio di pagamento e attraverso la quale viene effettuata la transazione.
Un identificatore di canale appartiene a un solo intermediario/broker PSP e di conseguenza deve essere univoco rispetto al PSP.
body
password *
Password del canale, assegnata da PagoPA.
body
qrCode *
è composto da
fiscalCode
e
noticeNumber.
body
fiscalCode *
codice fiscale dell'EC.
body
noticeNumber *
[auxDigit][segregationCode][IUVBase][IUVCheckDigit]
1  <soapenv:Envelope>
2    <soapenv:Body>
3      <nod:verifyPaymentNoticeReq>
4        <idPSP>88888888888</idPSP>
5        <idBrokerPSP>88888888888</idBrokerPSP>
6        <idChannel>88888888888_01</idChannel>
7        <password>**********</password>
8        <qrCode>
9          <fiscalCode>77777777777</fiscalCode>
10          <noticeNumber>311111111112222222</noticeNumber>
11        </qrCode>
12      </nod:verifyPaymentNoticeReq>
13    </soapenv:Body>
14  </soapenv:Envelope>
15

Parametri

body
idPSP *
Identificativo del PSP, assegnato da PagoPA.
Il codice è generalmente rappresentato dal codice BIC (Bank Identifier Code) del PSP.
In assenza del codice BIC, o per gestire situazioni particolari, può essere utilizzato un altro codice, purché identifichi in modo univoco il PSP.
body
idBrokerPSP *
Identificativo dell'intermediario, assegnato da PagoPA.
Identificazione dell'intermediario/broker del PSP che fornisce l'accesso (canale) al PSP per l'erogazione del servizio.
Nota: l'intermediario/broker può coincidere con il PSP stesso.
body
idChannel *
Identificativo del canale, identifica una categoria di servizio di pagamento e attraverso la quale viene effettuata la transazione.
Un identificatore di canale appartiene a un solo intermediario/broker PSP e di conseguenza deve essere univoco rispetto al PSP.
body
password *
Password del canale, assegnata da PagoPA.
body
ccPost *
conto corrente postale dell'EC.
body
noticeNumber *
[auxDigit][segregationCode][IUVBase][IUVCheckDigit]
1  <soapenv:Envelope>
2    <soapenv:Body>
3      <nod:verificaBollettinoReq>
4        <idPSP>88888888888</idPSP>
5        <idBrokerPSP>88888888888</idBrokerPSP>
6        <idChannel>88888888888_01</idChannel>
7        <password>**********</password>
8        <ccPost>012345678912</ccPost>
9        <noticeNumber>311111111112222222</noticeNumber>
10      </nod:verificaBollettinoReq>
11    </soapenv:Body>
12  </soapenv:Envelope>
13

activatePaymentNotice

Parametri

body
idPSP *
Identificativo del PSP, assegnato da PagoPA.
Il codice è generalmente rappresentato dal codice BIC (Bank Identifier Code) del PSP.
In assenza del codice BIC, o per gestire situazioni particolari, può essere utilizzato un altro codice, purché identifichi in modo univoco il PSP.
body
idBrokerPSP *
Identificativo dell'intermediario, assegnato da PagoPA.
Identificazione dell'intermediario/broker del PSP che fornisce l'accesso (canale) al PSP per l'erogazione del servizio.
Nota: l'intermediario/broker può coincidere con il PSP stesso.
body
idChannel *
Identificativo del canale, identifica una categoria di servizio di pagamento e attraverso la quale viene effettuata la transazione.
Un identificatore di canale appartiene a un solo intermediario/broker PSP e di conseguenza deve essere univoco rispetto al PSP.
body
password *
Password del canale, assegnata da PagoPA.
body
idempotencyKey
Chiave di idempotenza
body
qrCode *
E' composto da
fiscalCode
e
noticeNumber.
body
fiscalCode *
Codice fiscale dell'EC.
body
noticeNumber *
[auxDigit][segregationCode][IUVBase][IUVCheckDigit]
body
expirationTime
Tempo di scadenza del token ( ms ), max 30 minuti.
La durata del token di pagamento può essere impostata in 2 modi:
- Implicitamente dalla piattaforma pagoPA, se non è impostato nella richiesta di activatePaymentNotice (valore di default durata = 30 minuti)
- Esplicitamente dal PSP, se impostato in richiesta all'activatePaymentNotice
body
amount *
Importo in euro
body
dueDate
data di scadenza del pagamento secondo il formato ISO 8601 [AAAA]-[MM]-[GG]
body
paymentNote
Testo libero per descrivere l'oggetto del pagamento
1  <soapenv:Envelope>
2    <soapenv:Body>
3      <nod:activatePaymentNoticeReq>
4        <idPSP>88888888888</idPSP>
5        <idBrokerPSP>88888888888</idBrokerPSP>
6        <idChannel>88888888888_01</idChannel>
7        <password>**********</password>
8        <idempotencyKey>70000000001_100149bdWB</idempotencyKey>
9        <qrCode>
10          <fiscalCode>77777777777</fiscalCode>
11          <noticeNumber>311111111112222222</noticeNumber>
12        </qrCode>
13        <expirationTime>6000</expirationTime>
14        <amount>30.00</amount>
15      </nod:activatePaymentNoticeReq>
16    </soapenv:Body>
17  </soapenv:Envelope>
18

Parametri

**In questa versione è possibile far transitare i metadata per ogni **
payment
** e in ogni singolo **
transfer
** della response, inoltre sono gestite le informazioni ricavate da**
Gestione evoluta commissioni
.
body
idPSP *
Identificativo del PSP, assegnato da PagoPA.
Il codice è generalmente rappresentato dal codice BIC (Bank Identifier Code) del PSP.
In assenza del codice BIC, o per gestire situazioni particolari, può essere utilizzato un altro codice, purché identifichi in modo univoco il PSP.
body
idBrokerPSP *
Identificativo dell'intermediario, assegnato da PagoPA.
Identificazione dell'intermediario/broker del PSP che fornisce l'accesso (canale) al PSP per l'erogazione del servizio.
Nota: l'intermediario/broker può coincidere con il PSP stesso.
body
idChannel *
Identificativo del canale, identifica una categoria di servizio di pagamento e attraverso la quale viene effettuata la transazione.
Un identificatore di canale appartiene a un solo intermediario/broker PSP e di conseguenza deve essere univoco rispetto al PSP.
body
password *
Password del canale, assegnata da PagoPA.
body
idempotencyKey
Chiave di idempotenza
body
qrCode *
E' composto da
fiscalCode
e
noticeNumber.
body
fiscalCode *
Codice fiscale dell'EC.
body
noticeNumber *
[auxDigit][segregationCode][IUVBase][IUVCheckDigit]
body
expirationTime
Tempo di scadenza del token ( ms ), max 30 minuti.
La durata del token di pagamento può essere impostata in 2 modi:
- Implicitamente dalla piattaforma pagoPA, se non è impostato nella richiesta di activatePaymentNotice (valore di default durata = 30 minuti)
- Esplicitamente dal PSP, se impostato in richiesta all'activatePaymentNotice
body
amount *
Importo in euro
body
dueDate
data di scadenza del pagamento secondo il formato ISO 8601 [AAAA]-[MM]-[GG]
body
paymentNote
Testo libero per descrivere l'oggetto del pagamento
1  <soapenv:Envelope>
2    <soapenv:Body>
3      <nod:activatePaymentNoticeReq>
4        <idPSP>88888888888</idPSP>
5        <idBrokerPSP>88888888888</idBrokerPSP>
6        <idChannel>88888888888_01</idChannel>
7        <password>**********</password>
8        <idempotencyKey>70000000001_100149bdWB</idempotencyKey>
9        <qrCode>
10          <fiscalCode>77777777777</fiscalCode>
11          <noticeNumber>311111111112222222</noticeNumber>
12        </qrCode>
13        <expirationTime>6000</expirationTime>
14        <amount>30.00</amount>
15      </nod:activatePaymentNoticeReq>
16    </soapenv:Body>
17  </soapenv:Envelope>
18

sendPaymentOutcome

Parametri

body
idPSP *
identificativo del PSP, assegnato da PagoPA.
Il codice è generalmente rappresentato dal codice BIC (Bank Identifier Code) del PSP.
In assenza del codice BIC, o per gestire situazioni particolari, può essere utilizzato un altro codice, purché identifichi in modo univoco il PSP.
body
idBrokerPSP *
identificativo dell'intermediario, assegnato da PagoPA.
Identificazione dell'intermediario/broker del PSP che fornisce l'accesso (canale) al PSP per l'erogazione del servizio.
Nota: l'intermediario/broker può coincidere con il PSP stesso.
body
idChannel *
identificativo del canale, identifica una categoria di servizio di pagamento e attraverso la quale viene effettuata la transazione.
Un identificatore di canale appartiene a un solo intermediario/broker PSP e di conseguenza deve essere univoco rispetto al PSP.
body
password *
Password del canale, assegnata da PagoPA.
body
idempotencyKey
Chiave di idempotenza.
body
paymentToken *
Viene generato dal sistema durante la fase di attivazione del pagamento, è l'identificatore di correlazione da abbinare all'attivazione e all'esito del pagamento.
body
outcome *
Il risultato dell'operazione che può contenere i seguenti codici
OK : operazione eseguita con successo
KO : operazione terminata con errore
body
details
Dettagli del risultato dell'operazione, da inserire obbligatoriamente in caso di
outcome
OK
body
paymentMethod *
metodo di pagamento
enum: "cash" "creditCard" "bancomat" "other"
body
paymentChannel
canale di pagamento
enum: "frontOffice" "atm" "onLine" "app" "other"
body
fee *
importo della commissione pagata in euro
body
payer
individua il pagatore
body
uniqueIdentifier *
body
entityUniqueIdentifierType *
F : Persona fisica
G : Persona giuridica
body
entityUniqueIdentifierValue *
codice fiscale o partita IVA, nel caso non siano disponibili è possibile utilizzare 'ANONIMO'
body
fullName *
nome completo del pagatore
body
streetName
body
civicNumber
body
postalCode
body
city
body
stateProvinceRegion *
body
country
body
applicationDate *
data applicativa del pagamento
body
transferDate *
data del riversamento verso l'EC
1  <soapenv:Envelope>
2    <soapenv:Body>
3        <nod:sendPaymentOutcomeReq>
4          <idPSP>88888888888</idPSP>
5          <idBrokerPSP>88888888888</idBrokerPSP>
6          <idChannel>88888888888_01</idChannel>
7          <password>**********</password>
8          <idempotencyKey>70000000001_100149bdWB</idempotencyKey>
9          <paymentToken>c110729d258c4ab1b765fe902aae41d6</paymentToken>
10          <outcome>OK</outcome>
11          <details>
12              <paymentMethod>creditCard</paymentMethod>
13              <paymentChannel>app</paymentChannel>
14              <fee>2.00</fee>
15              <payer>
16                <uniqueIdentifier>
17                    <entityUniqueIdentifierType>F</entityUniqueIdentifierType>
18                    <entityUniqueIdentifierValue>JHNDOE00A01F205N</entityUniqueIdentifierValue>
19                </uniqueIdentifier>
20                <fullName>John Doe</fullName>
21                <streetName>street</streetName>
22                <civicNumber>12</civicNumber>
23                <postalCode>89020</postalCode>
24                <city>city</city>
25                <stateProvinceRegion>MI</stateProvinceRegion>
26                <country>IT</country>
27                <e-mail>john.doe@test.it</e-mail>
28              </payer>
29              <applicationDate>2021-10-01</applicationDate>
30              <transferDate>2021-10-02</transferDate>
31          </details>
32        </nod:sendPaymentOutcomeReq>
33    </soapenv:Body>
34  </soapenv:Envelope>
35

Parametri

Utilizzata per il pagamento attivato presso il frontend dell'EC, rispetto alla versione 1 permette di inviare l'outcome di più payment tokens contemporaneamente, inoltre sono gestite le informazioni ricavate da
Gestione evoluta commissioni
e il servizio @e.bollo.
body
idPSP *
Identificativo del PSP, assegnato da PagoPA.
Il codice è generalmente rappresentato dal codice BIC (Bank Identifier Code) del PSP.
In assenza del codice BIC, o per gestire situazioni particolari, può essere utilizzato un altro codice, purché identifichi in modo univoco il PSP.
body
idBrokerPSP *
Identificativo dell'intermediario, assegnato da PagoPA.
Identificazione dell'intermediario/broker del PSP che fornisce l'accesso (canale) al PSP per l'erogazione del servizio.
Nota: l'intermediario/broker può coincidere con il PSP stesso.
body
idChannel *
Identificativo del canale, identifica una categoria di servizio di pagamento e attraverso la quale viene effettuata la transazione.
Un identificatore di canale appartiene a un solo intermediario/broker PSP e di conseguenza deve essere univoco rispetto al PSP.
body
password *
Password del canale, assegnata da PagoPA.
body
idempotencyKey
Chiave di idempotenza
body
paymentTokens *
sequence che contiene tutti i tokens
body
paymentToken *
viene generato dal sistema durante la fase di attivazione del pagamento, è l'identificatore di correlazione da abbinare all'attivazione e all'esito del pagamento
body
outcome *
il risultato dell'operazione che può contenere i seguenti codici
OK : operazione eseguita con successo
KO : operazione terminata con errore
body
details
dettagli del risultato dell'operazione, da inserire obbligatoriamente in caso di
outcome
OK
body
paymentMethod *
metodo di pagamento
enum: "cash" "creditCard" "bancomat" "other"
body
paymentChannel
canale di pagamento
enum: "frontOffice" "atm" "onLine" "app" "other"
body
fee *
importo della commissione pagata in euro
body
primaryCiIncurredFee
importo della commissione a carico dell'EC espresso in euro ricavato da
Gestione evoluta commissioni
body
idBundle
identificativo del pacchetto di
Gestione evoluta commissioni
body
idCiBundle
identificativo degli attributi aggiunti dall'EC al pacchetto di
Gestione evoluta commissioni
body
payer
individua il pagatore
body
uniqueIdentifier *
body
entityUniqueIdentifierType *
F : Persona fisica
G : Persona giuridica
body
entityUniqueIdentifierValue *
codice fiscale o partita IVA, nel caso non siano disponibili è possibile utilizzare 'ANONIMO'
body
fullName *
nome completo del pagatore
body
streetName
body
civicNumber
body
postalCode
body
city
body
stateProvinceRegion *
body
country
body
applicationDate *
data applicativa del pagamento
body
transferDate *
data del riversamento verso l'EC
body
marcheDaBollo
La lista delle marche da bollo digitali gestite nella transazione di pagamento
body
marcaDaBollo
I dati di ogni singola marca da bollo digitale
body
paymentToken
Il paymentToken con cui è arrivata la richiesta di marca da bollo digitale
body
idTransfer
L'identificativo del transfer che contiene il dato
richiestaMarcaDaBollo
body
MBDAttachment
Il documento XML che contiene la marca da bollo digitale, nel formato base64
1  <soapenv:Envelope>
2    <soapenv:Body>
3        <nod:sendPaymentOutcomeReq>
4          <idPSP>88888888888</idPSP>
5          <idBrokerPSP>88888888888</idBrokerPSP>
6          <idChannel>88888888888_01</idChannel>
7          <password>**********</password>
8          <idempotencyKey>70000000001_100149bdWB</idempotencyKey>
9          <paymentTokens>
10              <paymentToken>d221820d258c4ab1b765fe902aae6d14</paymentToken>
11              <paymentToken>c110729d258c4ab1b765fe902aae41d6</paymentToken>
12          </paymentTokens>
13          <outcome>OK</outcome>
14          <details>
15              <paymentMethod>creditCard</paymentMethod>
16              <paymentChannel>app</paymentChannel>
17              <fee>2.00</fee>
18              <primaryCiIncurredFee>0.50</primaryCiIncurredFee>
19              <idBundle>1</idBundle>
20              <idCiBundle>2</idCiBundle>
21              <payer>
22                <uniqueIdentifier>
23                    <entityUniqueIdentifierType>F</entityUniqueIdentifierType>
24                    <entityUniqueIdentifierValue>JHNDOE00A01F205N</entityUniqueIdentifierValue>
25                </uniqueIdentifier>
26                <fullName>John Doe</fullName>
27                <streetName>street</streetName>
28                <civicNumber>12</civicNumber>
29                <postalCode>89020</postalCode>
30                <city>city</city>
31                <stateProvinceRegion>MI</stateProvinceRegion>
32                <country>IT</country>
33                <e-mail>john.doe@test.it</e-mail>
34              </payer>
35              <applicationDate>2021-10-01</applicationDate>
36              <transferDate>2021-10-02</transferDate>
37          </details>
38        </nod:sendPaymentOutcomeReq>
39    </soapenv:Body>
40  </soapenv:Envelope>
41

pspNotifyPayment

Parametri

body
idPSP *
Identificativo del PSP, assegnato da PagoPA.
Il codice è generalmente rappresentato dal codice BIC (Bank Identifier Code) del PSP.
In assenza del codice BIC, o per gestire situazioni particolari, può essere utilizzato un altro codice, purché identifichi in modo univoco il PSP.
body
idBrokerPSP *
Identificativo dell'intermediario, assegnato da PagoPA.
Identificazione dell'intermediario/broker del PSP che fornisce l'accesso (canale) al PSP per l'erogazione del servizio.
Nota: l'intermediario/broker può coincidere con il PSP stesso.
body
idChannel *
Identificativo del canale, identifica una categoria di servizio di pagamento e attraverso la quale viene effettuata la transazione.
Un identificatore di canale appartiene a un solo intermediario/broker PSP e di conseguenza deve essere univoco rispetto al PSP.
body
paymentToken *
Viene generato dal sistema durante la fase di attivazione del pagamento, è l'identificatore di correlazione da abbinare all'attivazione e all'esito del pagamento.
body
paymentDescription *
Testo libero per descrivere l'oggetto del pagamento.
body
fiscalCodePA *
Codice fiscale dell'EC.
body
companyName *
Nome completo dell'EC.
body
officeName
Nome completo dell'ufficio dell'EC.
body
creditorReferenceId *
IUV
Identificativo Univoco Versamento.
body
debtAmount *
Rappresenta la somma degli importi dei singoli transfer.
body
transferList *
Struttura che contiene i dettagli dei transfer pagamento, al momento i transfer possono essere al massimo 5.
body
transfer *
body
idTransfer *
Indice della lista (da 1 a 5).
body
transferAmount *
Importo
body
fiscalCodePA *
Codice fiscale dell'EC.
body
IBAN *
IBAN sul quale sarà effettuato il riversamento
body
remittanceInformation *
Motivo del pagamento.
body
dati specifici del canale di pagamento *
Struttura dati specifica del canale di pagamento utilizzato.
1    <soapenv:Envelope>
2      <soapenv:Body>
3          <pspfn:pspNotifyPaymentReq>
4            <idPSP>88888888888</idPSP>
5            <idBrokerPSP>88888888888</idBrokerPSP>
6            <idChannel>88888888888_01</idChannel>
7            <paymentDescription>test</paymentDescription>
8            <fiscalCodePA>77777777777</fiscalCodePA>
9            <companyName>company EC</companyName>
10            <officeName>office EC</officeName>                        
11            <paymentToken>ac6536ab9967401fb6cfa98bef88ccf0</paymentToken>
12            <creditorReferenceId>11111111112222222</creditorReferenceId>
13            <debtAmount>30.00</debtAmount>
14            <transferList>
15                <transfer>
16                  <idTransfer>1</idTransfer>
17                  <transferAmount>20.00</transferAmount>
18                  <fiscalCodePA>77777777777</fiscalCodePA>
19                  <IBAN>IT0000000000000000000000000</IBAN>
20                  <remittanceInformation>info remittance</remittanceInformation>
21                </transfer>
22                <transfer>
23                  <idTransfer>2</idTransfer>
24                  <transferAmount>10.00</transferAmount>
25                  <fiscalCodePA>77777777778</fiscalCodePA>
26                  <IBAN>IT0000000000000000000000001</IBAN>
27                  <remittanceInformation>info remittance</remittanceInformation>
28                </transfer>
29            </transferList>
30            
31            <!-- dati specifici del canale di pagamento -->
32            
33          </pspfn:pspNotifyPaymentReq>
34      </soapenv:Body>
35    </soapenv:Envelope>
36

Parametri

**Utilizzata per il pagamento attivato presso il frontend dell'EC, rispetto alla precedente versione della pspNotifyPayment permette di inviare al PSP una lista di **
payment
**, inoltre, le informazioni specifiche del pagamento utilizzato sono inserite nella sezione **
additionalPaymentInformations
** che contiene una lista di metadata. E' possibile, inoltre, inserire i metadata per ogni **
payment
** e in ogni singolo **
transfer
** e gestire il servizio @e.bollo.**
body
idPSP *
Identificativo del PSP, assegnato da PagoPA.
Il codice è generalmente rappresentato dal codice BIC (Bank Identifier Code) del PSP.
In assenza del codice BIC, o per gestire situazioni particolari, può essere utilizzato un altro codice, purché identifichi in modo univoco il PSP.
body
idBrokerPSP *
Identificativo dell'intermediario, assegnato da PagoPA.
Identificazione dell'intermediario/broker del PSP che fornisce l'accesso (canale) al PSP per l'erogazione del servizio.
Nota: l'intermediario/broker può coincidere con il PSP stesso.
body
idChannel *
Identificativo del canale, identifica una categoria di servizio di pagamento e attraverso la quale viene effettuata la transazione.
Un identificatore di canale appartiene a un solo intermediario/broker PSP e di conseguenza deve essere univoco rispetto al PSP.
body
transactionId *
Identificativo dell'operazione di pagamento.
body
totalAmount *
Rappresenta la somma pagata dall'utente, comprensiva di commissione.
body
fee *
Importo della commissione.
body
timestampOperation *
Timestamp dell'operazione di pagamento.
body
paymentList *
Lista dei pagamenti.
body
payment *
body
paymentToken *
Viene generato dal sistema durante la fase di attivazione del pagamento, è l'identificatore di correlazione da abbinare all'attivazione e all'esito del pagamento.
body
paymentDescription *
Testo libero per descrivere l'oggetto del pagamento.
body
fiscalCodePA *
Codice fiscale dell'EC.
body
companyName *
Nome completo dell'EC.
body
officeName
Nome completo dell'ufficio dell'EC.
body
creditorReferenceId *
IUV
Identificativo Univoco Versamento.
body
debtAmount *
Rappresenta la somma degli importi dei singoli transfer.
body
transferList *
Struttura che contiene i dettagli dei transfer pagamento, al momento i transfer possono essere al massimo 5.
body
transfer *
body
idTransfer *
Indice della lista (da 1 a 5).
body
transferAmount *
Importo
body
fiscalCodePA *
Codice fiscale dell'EC.
body
CHOICE *
Choice tra IBAN e richiestaMarcaDaBollo
body
IBAN *
IBAN sul quale sarà effettuato il riversamento
body
richiestaMarcaDaBollo
I dati della richiesta della marca da bollo
body
tipoBollo
Tipologia del bollo
body
hashDocumento
Impronta informatica (digest), nel formato base64, del documento informatico o della segnatura di protocollo cui è associata la marca da bollo digitale
body
provinciaResidenza
Sigla automobilistica della provincia di residenza del soggetto pagatore
body
remittanceInformation *
Motivo del pagamento.
body
additionalPaymentInformations
Struttura che contiene i dati specifici del canale di pagamento utilizzato.
body
additionalPaymentList *
body
mapEntry *
body
key *
body
value *
1      <soapenv:Body>
2          <pspfn:pspNotifyPaymentV2>
3            <idPSP>CIPBITMM</idPSP>
4            <idBrokerPSP>13212880150</idBrokerPSP>
5            <idChannel>13212880150_02</idChannel>
6            <transactionId>99910087308786</transactionId>
7            <totalAmount>31.00</totalAmount>
8            <fee>1.00</fee>
9            <timestampOperation>2033-04-23T18:25:43Z</timestampOperation>
10            <paymentList>
11              <payment>
12                <paymentDescription>test</paymentDescription>
13                <fiscalCodePA>77777777777</fiscalCodePA>
14                <companyName>company EC</companyName>
15                <officeName>office EC</officeName>                        
16                <paymentToken>ac6536ab9967401fb6cfa98bef88ccf0</paymentToken>
17                <creditorReferenceId>11111111112222222</creditorReferenceId>
18                <debtAmount>30.00</debtAmount>
19                <transferList>
20                  <transfer>
21                    <idTransfer>1</idTransfer>
22                    <transferAmount>20.00</transferAmount>
23                    <fiscalCodePA>77777777777</fiscalCodePA>
24                    <IBAN>IT0000000000000000000000000</IBAN>
25                    <remittanceInformation>info remittance</remittanceInformation>
26                    <metadata>
27                      <mapEntry>
28                        <key>yyyy</key>
29                        <value>abcde</value>
30                      </mapEntry> 
31                    </metadata>
32                  </transfer>
33                  <transfer>
34                    <idTransfer>2</idTransfer>
35                    <transferAmount>10.00</transferAmount>
36                    <fiscalCodePA>77777777778</fiscalCodePA>
37                    <IBAN>IT0000000000000000000000001</IBAN>
38                    <remittanceInformation>info remittance</remittanceInformation>
39                  </transfer>
40                </transferList> 
41                <metadata>
42                  <mapEntry>
43                    <key>zzzz</key>
44                    <value>g2f3</value>
45                  </mapEntry> 
46                </metadata>
47              </payment>
48            </paymentList>                       
49            <additionalPaymentInformations>
50              <mapEntry>
51                <key>xxxx</key>
52                <value>1234546</value>
53              </mapEntry> 
54            </additionalPaymentInformations>
55          </pspfn:pspNotifyPaymentV2>
56      </soapenv:Body>
57    </soapenv:Envelope>    
58

Parametri

body
idPSP *
Identificativo del PSP, assegnato da PagoPA.
Il codice è generalmente rappresentato dal codice BIC (Bank Identifier Code) del PSP.
In assenza del codice BIC, o per gestire situazioni particolari, può essere utilizzato un altro codice, purché identifichi in modo univoco il PSP.
body
idBrokerPSP *
Identificativo dell'intermediario, assegnato da PagoPA.
Identificazione dell'intermediario/broker del PSP che fornisce l'accesso (canale) al PSP per l'erogazione del servizio.
Nota: l'intermediario/broker può coincidere con il PSP stesso.
body
idChannel *
Identificativo del canale, identifica una categoria di servizio di pagamento e attraverso la quale viene effettuata la transazione.
Un identificatore di canale appartiene a un solo intermediario/broker PSP e di conseguenza deve essere univoco rispetto al PSP.
body
password *
Password del canale, assegnata da PagoPA.
body
idSoggettoServizio *
Identificativo dell'associazione tra servizio e EC per cui si vuole attivare il pagamento. Corrisponde al tag elencoSoggettiEroganti.soggettoErogante.idSoggettoServizio del Catalogo dei Servizi.
body
datiSpecificiServizio *
Sono censiti nel Catalogo dei Servizi, che è il repository che contiene l’elenco dei servizi generalizzati attivati dagli EC, inviati in formato base64. La struttura da inserire è definita dallo schema XSD il cui nome è riportato nell'elemento
xsdRiferimento
del Catalogo dei Servizi ed è consultabile tramite
https://github.com/pagopa/pagopa-api
.
1<soap:Envelope>
2  <soap:Body>
3    <ns3:demandPaymentNoticeReq>
4      <idPSP>88888888888</idPSP>
5      <idBrokerPSP>88888888888</idBrokerPSP>
6      <idChannel>88888888888_01</idChannel>
7      <password>**********</password>
8      <idSoggettoServizio>00003</idServizio>
9      <datiSpecificiServizio>Dati del servizio base64 encoded</datiSpecificiServizio>
10    </ns3:demandPaymentNoticeReq>
11  </soap:Body>
12</soap:Envelope>
13

Parametri

body
idPA *
Codice fiscale della struttura che invia la richiesta di pagamento.
body
idBrokerPA *
Identificativo del soggetto che opera come intermediario per l'EC.
body
idStation *
Identificativo della stazione dell'EC nel sistema pagoPa.
body
idServizio *
Identificativo del servizio per cui si vuole attivare il pagamento.
body
datiSpecificiServizio *
Sono censiti nel Catalogo dei Servizi, che è il repository che contiene l’elenco dei servizi generalizzati attivati dagli EC, inviati in formato base64.
1<soapenv:Envelope>
2  <soapenv:Body>
3    <ppt:paDemandPaymentNoticeReq>
4      <idPA>77777777777</idPA>
5      <idBrokerPA>77777777777</idBrokerPA>
6      <idStation>77777777777_01</idStation>
7      <idServizio>00002</idServizio>       
8      <datiSpecificiServizio>Dati del servizio base64 encoded</datiSpecificiServizio>
9    </ppt:paDemandPaymentNoticeReq>
10  </soapenv:Body>
11</soapenv:Envelope>
12

Parametri

body
identificativoPSP *
Identificativo del PSP, assegnato da PagoPA.
Il codice è generalmente rappresentato dal codice BIC (Bank Identifier Code) del PSP.
In assenza del codice BIC, o per gestire situazioni particolari, può essere utilizzato un altro codice, purché identifichi in modo univoco il PSP.
body
identificativoIntermediarioPSP *
Identificativo dell'intermediario, assegnato da PagoPA.
Identificazione dell'intermediario/broker del PSP che fornisce l'accesso (canale) al PSP per l'erogazione del servizio.
Nota: l'intermediario/broker può coincidere con il PSP stesso.
body
identificativoCanale *
Identificativo del canale, identifica una categoria di servizio di pagamento e attraverso la quale viene effettuata la transazione.
Un identificatore di canale appartiene a un solo intermediario/broker PSP e di conseguenza deve essere univoco rispetto al PSP.
body
password *
Password del canale, assegnata da PagoPA.
body
identificativoDominio *
Codice fiscale dell'EC.
body
identificativoFlusso *
Identificativo del Flusso di Rendicontazione.
body
dataOraFlusso *
Data e ora del Flusso di Rendicontazione.
body
xmlRendicontazione *
Contenuto del Flusso di riversamento in formato base64.
1<soap:Envelope>
2    <soap:Body>
3        <ns5:nodoInviaFlussoRendicontazione>
4            <identificativoPSP>88888888888</identificativoPSP>
5            <identificativoIntermediarioPSP>88888888888</identificativoIntermediarioPSP>
6            <identificativoCanale>88888888888_01</identificativoCanale>
7            <password>**********</password>
8            <identificativoDominio>77777777777</identificativoDominio>
9            <identificativoFlusso>2021-11-2188888888888-AABB648200001295</identificativoFlusso>
10            <dataOraFlusso>2021-11-22T00:37:32</dataOraFlusso>
11            <xmlRendicontazione>Flusso di riversamento base64 encoded</xmlRendicontazione>
12        </ns5:nodoInviaFlussoRendicontazione>
13    </soap:Body>
14</soap:Envelope>
15

Parametri

body
identificativoIntermediarioPA *
Identificativo del soggetto che opera come intermediario per l'EC.
body
identificativoStazioneIntermediarioPA *
Identificativo della stazione dell'EC nel sistema pagoPa.
body
password *
Password della stazione, assegnata da PagoPA.
body
identificativoDominio *
Codice fiscale dell'EC.
body
identificativoPSP *
Identificativo del PSP, assegnato da PagoPA.
Il codice è generalmente rappresentato dal codice BIC (Bank Identifier Code) del PSP.
In assenza del codice BIC, o per gestire situazioni particolari, può essere utilizzato un altro codice, purché identifichi in modo univoco il PSP.
1<soap:Envelope>
2    <soap:Body>
3        <ns5:nodoChiediElencoFlussiRendicontazione>
4            <identificativoIntermediarioPA>77777777777</identificativoIntermediarioPA>
5            <identificativoStazioneIntermediarioPA>77777777777_01</identificativoStazioneIntermediarioPA>
6            <password>**********</password>
7            <identificativoDominio>77777777777</identificativoDominio>
8            <identificativoPSP>88888888888</identificativoPSP>
9        </ns5:nodoChiediElencoFlussiRendicontazione>
10    </soap:Body>
11</soap:Envelope>
12

Parametri

body
identificativoIntermediarioPA *
Identificativo del soggetto che opera come intermediario per l'EC.
body
identificativoStazioneIntermediarioPA *
Identificativo della stazione dell'EC nel sistema pagoPa.
body
password *
Password della stazione, assegnata da PagoPA.
body
identificativoDominio *
Codice fiscale dell'EC.
body
identificativoPSP *
Identificativo del PSP, assegnato da PagoPA.
Il codice è generalmente rappresentato dal codice BIC (Bank Identifier Code) del PSP.
In assenza del codice BIC, o per gestire situazioni particolari, può essere utilizzato un altro codice, purché identifichi in modo univoco il PSP.
body
identificativoFlusso *
Identificativo del Flusso di Rendicontazione.
1<soap:Envelope>
2    <soap:Body>
3        <nodoChiediElencoFlussiRendicontazione>
4            <identificativoIntermediarioPA>77777777777</identificativoIntermediarioPA>
5            <identificativoStazioneIntermediarioPA>77777777777_01</identificativoStazioneIntermediarioPA>
6            <password>**********</password>
7            <identificativoDominio>77777777777</identificativoDominio>
8            <identificativoPSP>88888888888</identificativoPSP>
9            <identificativoFlusso>2021-11-2188888888888-AABB648200001295</identificativoFlusso>
10        </nodoChiediElencoFlussiRendicontazione>
11    </soap:Body>
12</soap:Envelope>
13

Parametri

body
identificativoPSP *
Identificativo del PSP, assegnato da PagoPA.
Il codice è generalmente rappresentato dal codice BIC (Bank Identifier Code) del PSP.
In assenza del codice BIC, o per gestire situazioni particolari, può essere utilizzato un altro codice, purché identifichi in modo univoco il PSP.
body
identificativoIntermediarioPSP *
Identificativo dell'intermediario, assegnato da PagoPA.
Identificazione dell'intermediario/broker del PSP che fornisce l'accesso (canale) al PSP per l'erogazione del servizio.
Nota: l'intermediario/broker può coincidere con il PSP stesso.
body
identificativoCanale *
Identificativo del canale, identifica una categoria di servizio di pagamento e attraverso la quale viene effettuata la transazione.
Un identificatore di canale appartiene a un solo intermediario/broker PSP e di conseguenza deve essere univoco rispetto al PSP.
body
password *
Password del canale, assegnata da PagoPA.
body
identificativoDominio *
Codice fiscale dell'EC.
1<soap:Envelope>
2    <soap:Body>
3        <ns5:nodoChiediInformativaPA>
4            <identificativoPSP>88888888888</identificativoPSP>
5            <identificativoIntermediarioPSP>88888888888</identificativoIntermediarioPSP>
6            <identificativoCanale>88888888888_01</identificativoCanale>
7            <password>**********</password>
8            <identificativoDominio>77777777777</identificativoDominio>
9        </ns5:nodoChiediInformativaPA>
10    </soap:Body>
11</soap:Envelope>
12

Parametri

body
identificativoPSP *
Identificativo del PSP, assegnato da PagoPA.
Il codice è generalmente rappresentato dal codice BIC (Bank Identifier Code) del PSP.
In assenza del codice BIC, o per gestire situazioni particolari, può essere utilizzato un altro codice, purché identifichi in modo univoco il PSP.
body
identificativoIntermediarioPSP *
Identificativo dell'intermediario, assegnato da PagoPA.
Identificazione dell'intermediario/broker del PSP che fornisce l'accesso (canale) al PSP per l'erogazione del servizio.
Nota: l'intermediario/broker può coincidere con il PSP stesso.
body
identificativoCanale *
Identificativo del canale, identifica una categoria di servizio di pagamento e attraverso la quale viene effettuata la transazione.
Un identificatore di canale appartiene a un solo intermediario/broker PSP e di conseguenza deve essere univoco rispetto al PSP.
body
password *
Password del canale, assegnata da PagoPA.
body
identificativoDominio *
Codice fiscale dell'EC.
body
categoria
Filtro in base alla categoria dei servizi.
body
commissione
Filtro in base al consiglio di applicare o meno le commissioni inserite dall'EC che ha creato il servizio.
1<soap:Envelope>
2    <soap:Body>
3        <ns5:nodoChiediCatalogoServizi>
4            <identificativoPSP>88888888888</identificativoPSP>
5            <identificativoIntermediarioPSP>88888888888</identificativoIntermediarioPSP>
6            <identificativoCanale>88888888888_01</identificativoCanale>
7            <password>**********</password>
8            <identificativoDominio>77777777777</identificativoDominio>
9            <categoria>Donazioni</categoria>
10            <commissione>N</commissione>
11        </ns5:nodoChiediCatalogoServizi>
12    </soap:Body>
13</soap:Envelope>
14

Parametri

body
identificativoPSP *
Identificativo del PSP, assegnato da PagoPA.
Il codice è generalmente rappresentato dal codice BIC (Bank Identifier Code) del PSP.
In assenza del codice BIC, o per gestire situazioni particolari, può essere utilizzato un altro codice, purché identifichi in modo univoco il PSP.
body
identificativoIntermediarioPSP *
Identificativo dell'intermediario, assegnato da PagoPA.
Identificazione dell'intermediario/broker del PSP che fornisce l'accesso (canale) al PSP per l'erogazione del servizio.
Nota: l'intermediario/broker può coincidere con il PSP stesso.
body
identificativoCanale *
Identificativo del canale, identifica una categoria di servizio di pagamento e attraverso la quale viene effettuata la transazione.
Un identificatore di canale appartiene a un solo intermediario/broker PSP e di conseguenza deve essere univoco rispetto al PSP.
body
password *
Password del canale, assegnata da PagoPA.
1<soap:Envelope>
2    <soap:Body>
3        <ns5:nodoChiediTemplateInformativaPSP>
4            <identificativoPSP>88888888888</identificativoPSP>
5            <identificativoIntermediarioPSP>88888888888</identificativoIntermediarioPSP>
6            <identificativoCanale>88888888888_01</identificativoCanale>
7            <password>**********</password>
8        </ns5:nodoChiediTemplateInformativaPSP>
9    </soap:Body>
10</soap:Envelope>
11

EC Checkout API

Parametri

In questa pagina

paGetPayment

paSendRT

activatePaymentNotice

sendPaymentOutcome

pspNotifyPayment

EC Checkout API

Serve aiuto?

Apri un ticket utilizzando l’apposita funzione all’interno della tua Area Riservata

Dicci cosa ne pensi

Per chiarimenti sulle specifiche d’implementazione, come SACI e SANP, puoi aprire una segnalazione su GitHub