Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Submit documents by sending a POST request to the /documents resource path. After successful submission, the location of the new document is returned in the Location header.

Info

Please note that we reject and don’t process files with wrong format or bad quality. In this case we return 400 error in the response message.

The Gini Pay API currently supports two different variants of uploads, one optimized for web applications running in a web browser and the other for all other types of clients. The first variant optimized for web applications expects the documents to be uploaded using a multipart/form-data encoding method. The second variant for all other clients simply uses the request body (independent of the request Content-Type) as the document.

...

Status Code

Description

400 (Bad Request)

Returned when a file is sent in an invalid format or has a bad quality which we are unable to process.

401 (Unauthorized)

Authorization credentials are either missing, wrong or outdated.

415

Content type is not supported.

503

Service unavailable. Try again later.

...

Key

Value

amountToPay

25.79:EUR

bic

SPESDE3EXXX

paymentReference

Nr.12345

See the full complete QR code request example below.

Request

In order to upload a page picture or a partial document, specify a different content type:

...

Status Code

Description

400 (Bad Request)

Returned when the send sent file has invalid format or has a bad quality which we are unable to process.

401 (Unauthorized)

Authorization credentials are either missing, wrong or outdated.

415

Content type is not supported.

503

Service unavailable. Try again later.

...

Status Code

Description

400 (Bad Request)

Returned when a file was sent in an invalid format is sentor has a bad quality which we are unable to process.

401 (Unauthorized)

Authorization credentials are either missing, wrong or outdated.

415

Content type not supported.

503

Service unavailable. Try again later.

...