DevPortalPagoPA




Table of contents

Options with multiple installment plans (with or without the total option)

With this scenario, it is possible to manage various installment plans. Once the citizen makes a payment for an installment plan, the OdP (payment options) for the other plans and/or the possible single-payment option must be disabled and therefore no longer shown by the PSP, the output returned must be only the OdP with the installments still to be paid. Example of a response that the EC must provide and that the PSP must expose for this case:
1[
2  {
3    "paTaxCode": "99999000013",
4    "paFullName": "EC",
5    "paOfficeName": "EC",
6    "paymentOptions": [
7      {
8        "description": "Test PayOpt - Option 1 - One-time payment",
9        "numberOfInstallments": 1,
10        "amount": 120,
11        "dueDate": "2024-10-30T23:59:59",
12        "validFrom": "2024-09-30T23:59:59",
13        "status": not paid,
14        "statusReason": "desc",
15        "allCCP": "false",
16        "installments": [
17          {
18            "nav": "347000000880099993",
19            "iuv": "47000000880099993",
20            "amount": 120,
21            "description": "Test Opt Inst - soluzione unica",
22            "dueDate": "2024-10-30T23:59:59",
23            "validFrom": "2024-09-30T23:59:59",
24            "status": not paid,
25            "statusReason": "desc"
26          }
27        ]
28      },
29      {
30        "description": "Test PayOpt - Option 2 - Installment plan - 2 installments",
31        "numberOfInstallments": 2,
32        "amount": 90,
33        "dueDate": "2024-12-31T23:59:59",
34        "validFrom": "2024-09-30T23:59:59",
35        "status": not paid,
36        "statusReason": "desc",
37        "allCCP": "false",
38        "installments": [
39          {
40            "nav": "346000000880099993",
41            "iuv": "46000000880099993",
42            "amount": 30,
43            "description": "installment 1",
44            "dueDate": "2024-10-31T23:59:59",
45            "validFrom": "2024-09-30T23:59:59",
46            "status": not paid,
47            "statusReason": "desc"
48          },
49          {
50            "nav": "345000000880099993",
51            "iuv": "45000000880099993",
52            "amount": 30,
53            "description": "installment 2",
54            "dueDate": "2024-11-30T23:59:59",
55            "validFrom": "2024-09-30T23:59:59",
56            "status": not paid,
57            "statusReason": "desc"
58          }
59        ]
60      },
61      {
62        "description": "Test PayOpt - Option 3 - Installment plan - 3 installments",
63        "numberOfInstallments": 3,
64        "amount": 90,
65        "dueDate": "2024-12-31T23:59:59",
66        "validFrom": "2024-09-30T23:59:59"",
67        "status": not paid,
68        "statusReason": "desc",
69        "allCCP": false,
70        "installments": [
71          {
72            "nav": "344000000880099993",
73            "iuv": "44000000880099993",
74            "amount": 18,
75            "description": "installment 1",
76            "dueDate": "2024-10-31T23:59:59",
77            "validFrom": "2024-09-30T23:59:59",
78            "status": not paid,
79            "statusReason": "desc"
80          },
81          {
82            "nav": "343000000880099993",
83            "iuv": "43000000880099993",
84            "amount": 18,
85            "description": "installment 2",
86            "dueDate": "2024-11-30T23:59:59",
87            "validFrom": "2024-09-30T23:59:59",
88            "status": not paid,
89            "statusReason": "desc"
90          },
91          {
92            "nav": "342000000880099993",
93            "iuv": "42000000880099993",
94            "amount": 18,
95            "description": "installment 3",
96            "dueDate": "2024-12-31T23:59:59",
97            "validFrom": "2024-09-30T23:59:59",
98            "status": "not paid",
99            "statusReason": "desc"
100          }
101        ]
102      }
103    ]
104  }
105]
106
107

Need help?

Open a ticket using the dedicated function within your Reserved Area

Tell us what you think

For clarifications on implementation specifications, such as SACI and SANP, you can open an issue on GitHub