User Identification

User Identification API is used to provide identity documents and face photos of clients to verify their identity, increase their transfer limits, grant access to some features provided by Paysera etc.

Data structures

Identification request data structure

Parameter Type Remarks Description
id integer always ID of a identification request
face_photos array of face photos if present Attached face photos to identification request
identity_documents array of identity documents if present Attached identity documents to identification request
user_id integer always User id
status string always One of these: waiting, processing, pending, reviewed. See below for explanation for each status.
comment string if present Comment is provided after identification request is reviewed. It will contain information what actions were taken. For example, user was identified and/or limits were increased.

Identification request status field definition list

Info Statuses are provided in sequence they change based on an action.
Parameter Explanation
waiting Waiting for identity documents and/or face photos to be attached
processing Identification request is being processed and prepared for Customer support to review
pending Identification request is queued for review
reviewed Identification request was reviewed

Face photo data structure

Parameter Type Remarks Description
link integer always Link to face photo
order integer always Order of image in identification request

Identity document data structure

Parameter Type Remarks Description
id integer always ID of a identity document
type string if present One of these: identity_card, passport, residence_permit
Deprecated parameter: driver_license
personal_number string if present Personal number
country string if present Country code provided in ISO-639-1 standard
date_of_birth string if present Date of birth provided in YYYY-MM-DD format (e.g. 1991-04-17)
first_name string if present First name
last_name string if present Last name
images array of identity document images if present Attached identity document images to identity document

Identity document image structure

Parameter Type Remarks Description
link integer always Link to identity document image
order integer always Order of image in identity document

Requests

Create identification request

POST https://wallet.paysera.com/rest/v1/user/:userId/identification-request

Parameters

userId
ID of the user

Response

Response is an identification request data structure.

Example request

POST /rest/v1/user/1/identification-request HTTP/1.1
Host: wallet.paysera.com
User-Agent: Paysera WalletApi PHP library
Authorization: MAC id="wkVd93h2uS", ts="1343811600", nonce="nQnNaSNyubfPErjRO55yaaEYo9YZfKHN", mac="VP7OZx/ItbyEHGNicOYD115jhOnysZqbDU88SPIaK18="

Example response

HTTP/1.1 200 OK
Content-type: application/json;charset=utf-8
{
    "id": 1,
    "status": "waiting",
    "user_id": "1"
}

Get identification request

GET https://wallet.paysera.com/rest/v1/identification-request/:identificationRequestId

Parameters

identificationRequestId
ID of the identification request

Response

Response is an identification request data structure.

Example request

GET /rest/v1/identification-request/1 HTTP/1.1
Host: wallet.paysera.com
User-Agent: Paysera WalletApi PHP library
Authorization: MAC id="wkVd93h2uS", ts="1343811600", nonce="nQnNaSNyubfPErjRO55yaaEYo9YZfKHN", mac="1iJpy3h7/r8QdRsDGicqwVuEB08WY/pp94F3dyIEmFU="

Example response

HTTP/1.1 200 OK
Content-type: application/json;charset=utf-8
{
    "id": 1,
    "status": "waiting",
    "user_id": "1"
}

Create identity document

POST https://wallet.paysera.com/rest/v1/identification-request/:identificationRequestId/identity-document

Parameters

identificationRequestId
ID of the identification request

Request body structure

Parameter Type Remarks Description
type string optional One of these: identity_card, passport, residence_permit
Deprecated parameter: driver_license
personal_number string optional Personal number
country string optional Country code provided in ISO-639-1 standard
date_of_birth string optional Date of birth provided in YYYY-MM-DD format (e.g. 1991-04-17)
first_name string optional First name
last_name string optional Last name

Response

Response is an identity document data structure.

Possible errors

HTTP status code Code Description
204 invalid_state Identification request is not in waiting state.

Example request

POST /rest/v1/identification-request/1/identity-document HTTP/1.1
Host: wallet.paysera.com
Content-Type: application/json;charset=utf-8
User-Agent: Paysera WalletApi PHP library
Authorization: MAC id="wkVd93h2uS", ts="1343811600", nonce="nQnNaSNyubfPErjRO55yaaEYo9YZfKHN", mac="eQ6x9vU+Sxs9/Tnrj3W9Y5ACOeXNuOCtJaFg/fm6/EA=", ext="body_hash=aYy6BMD4pS5iovwINcY4CnX7difMxYpz8p6w4WCotQw%3D"
{
    "type": "identity_card",
    "personal_number": "12345"
}

Example response

HTTP/1.1 200 OK
Content-type: application/json;charset=utf-8
{
    "id": 1,
    "type": "identity_card",
    "personal_number": "12345"
}

Attach image to identity document

PUT https://wallet.paysera.com/rest/v1/identity-document/:identityDocumentId/image/:order

Parameters

identityDocumentId
ID of the identity document
order
Order of identity document image. Must be unique per identity document.

Response

An empty response with HTTP status code of 200.

Possible errors

HTTP status code Code Description
204 invalid_state Identification request is not in waiting state.

Example request

POST /rest/v1/identity-document/1/image/0 HTTP/1.1
Host: wallet.paysera.com
Content-Type: application/x-www-form-urlencoded;charset=utf-8
User-Agent: Paysera WalletApi PHP library
Authorization: MAC id="wkVd93h2uS", ts="1343811600", nonce="nQnNaSNyubfPErjRO55yaaEYo9YZfKHN", mac="gmPhPe5AMQHO3BV5laB4C6mRGVwOb3Nv47BtSXCCmm4=", ext="body_hash=%2FJUKG6Zur99zq1gzxwtIQOwwTGWaGTkNvG6x%2FG8AlW8%3D"
<image binary data>

Example response

HTTP/1.1 200 OK

Attach face photo to identification request

PUT https://wallet.paysera.com/rest/v1/identification-request/:identificationRequestId/face-photo/image/:order

Parameters

identificationRequestId
ID of the identification request
order
Order of identification request face photo image. Must be unique per identification request.

Response

An empty response with HTTP status code of 200.

Possible errors

HTTP status code Code Description
204 invalid_state Identification request is not in waiting state.

Example request

POST /rest/v1/identity-document/1/image/0 HTTP/1.1
Host: wallet.paysera.com
Content-Type: application/x-www-form-urlencoded;charset=utf-8
User-Agent: Paysera WalletApi PHP library
Authorization: MAC id="wkVd93h2uS", ts="1343811600", nonce="nQnNaSNyubfPErjRO55yaaEYo9YZfKHN", mac="gmPhPe5AMQHO3BV5laB4C6mRGVwOb3Nv47BtSXCCmm4=", ext="body_hash=%2FJUKG6Zur99zq1gzxwtIQOwwTGWaGTkNvG6x%2FG8AlW8%3D"
<image binary data>

Example response

HTTP/1.1 200 OK

Submit identification request for a review

PUT https://wallet.paysera.com/rest/v1/identification-request/:identificationRequestId/submit

Parameters

identificationRequestId
ID of the identification request

Response

An empty response with HTTP status code of 200.

Possible errors

HTTP status code Code Description
204 invalid_state Identification request is not in waiting or pending state.

Example request

POST /rest/v1/identification-request/1/submit HTTP/1.1
Host: wallet.paysera.com
User-Agent: Paysera WalletApi PHP library
Authorization: MAC id="wkVd93h2uS", ts="1343811600", nonce="nQnNaSNyubfPErjRO55yaaEYo9YZfKHN", mac="Xxqm9DFdRI15gGVMUUly+C7kMquQ0vUPrnGXUDV0R3Q="

Example response

HTTP/1.1 200 OK