Create a new PagoPa payment

post

https://authservices.satispay.com/g_agent/v1/pagopa/payments

📘
Choose the correct endpoint
Keep in mind the endpoint you need to call, depending on your environment:

production: https://authservices.satispay.com/

staging: https://staging.authservices.satispay.com/

Body Params

request_type

string

required

Identifies how the payment proposal information are provided. Must contain only one of: MANUAL, BARCODE, ROAD_TAX. Consider that for a MANUAL request_type, both domain_id and payment_notice_number must be non empty strings.

barcode

string

The barcode of the IUV (mandatory for request_type = BARCODE)

barcode_type

string

Barcode taxonomy, used to parse the barcode_type field (required only for request_type = BARCODE) [BARCODE_GS1_128 or QR_CODE]

payment_notice_number

string

The IUV identifier (mandatory for request_type = MANUAL). To obtain this value for testing purposes, please contact us, providing the shop name.

domain_id

string

The EC(Ente Creditore) identifier (mandatory for request_type = MANUAL). To obtain this value for testing purposes, please contact us, providing the shop name.

amount_unit

string

Total net amount of the payment (mandatory for request_type = BARCODE)

license_plate

string

The vehicle identification number (mandatory for request_type=ROAD_TAX)

vehicle_type

string

Type of vehicle (mandatory for request_type=ROAD_TAX) [MOTORVEHICLE, TRAILER or MOTORCYCLE]

Headers

Host

string

The host declared in the signature

Date

string

The date declared in the signature

Digest

string

The digest declared in the signature

Authorization

string

The signature of the request

Idempotency-Key

string

The idempotent token of the request

string

enum

Defaults to application/json

Generated from available response content types

Allowed:

Responses

Language

Loading…

Response

Choose an example:

application/json

text/plain

Choose the correct endpoint

200200

400400

403403

504504