Get link to upload POI

POST/customers/poi

Generate a unique upload URL for each customer provided in the payload. Utilize the resulting URL(s) to submit their proof of identity documents to Triple-A.

Document supported types: Passport, Driving License, ID Card

Document supported format: JPG, JPEG, PNG, PDF

After uploading the proof of identity document, you will receive a verification result notification via a webhook at the notify_url you specified. More information can be found here.

Sample webhook:

{
    "customer_id": <customer_id>,
    "poi": {
        "id": <poi.id>,
        "status": "accepted" | "declined" | "invalid",
        "declined_reason": <null | reason to decline>
    }
}

The list of declined reasons can be found here.

Body application/json

filesobject[]required

Show files properties

customer_idstringrequired

optionsobject

Show options properties

filenamestringrequired

filetypestringrequired

File Format: image/jpeg | image/png | application/pdf

notify_urlstring

Response

Get pre-signed urls or error message

customer_idstring<uuid>

CustomerID of the customer

optionsobject

Show options properties

filenamestring

filetypestring

File Format: image/jpeg | image/png | application/pdf

error_messagestring

Description of error encountered while creating upload url

presigned_urlstring

S3 signed url to upload the document

idstring<uuid>

Poi Upload request ID on success

Invalid Payload

messagestring

errorsobject[]

Show errors properties

pathstring

messagestring

errorCodestring

Invalid/Expired Access Token

messagestring

errorsobject[]

Show errors properties

pathstring

messagestring

Server Error

messagestring

curl -X POST "https://api.triple-a.work/kyc-api/v1/customers/poi" \ -H "Content-Type: application/json" \ -H "Authorization: Bearer <token>" \ -d '{ "files": [ { "customer_id": "6d282e8c-128e-4153-ad65-601930a94e02", "options": { "filename": "example.txt", "filetype": "text/plain" }, "notify_url": "https://example.com/notify" }, { "customer_id": "4d37cbdc-9dbb-4604-82a7-8f8753366a68", "options": { "filename": "example.jpeg", "filetype": "image/jpeg" }, "notify_url": "https://example.com/notify" } ] }'

const response = await fetch(`https://api.triple-a.work/kyc-api/v1/customers/poi`, { method: 'POST', headers: { 'Content-Type': 'application/json', 'Authorization': 'Bearer <token>' }, body: JSON.stringify({ "files": [ { "customer_id": "6d282e8c-128e-4153-ad65-601930a94e02", "options": { "filename": "example.txt", "filetype": "text/plain" }, "notify_url": "https://example.com/notify" }, { "customer_id": "4d37cbdc-9dbb-4604-82a7-8f8753366a68", "options": { "filename": "example.jpeg", "filetype": "image/jpeg" }, "notify_url": "https://example.com/notify" } ] }) }); const data = await response.json();

import requests response = requests.request( "POST", "https://api.triple-a.work/kyc-api/v1/customers/poi", headers={ "Authorization": "Bearer <token>" }, json={ "files": [ { "customer_id": "6d282e8c-128e-4153-ad65-601930a94e02", "options": { "filename": "example.txt", "filetype": "text/plain" }, "notify_url": "https://example.com/notify" }, { "customer_id": "4d37cbdc-9dbb-4604-82a7-8f8753366a68", "options": { "filename": "example.jpeg", "filetype": "image/jpeg" }, "notify_url": "https://example.com/notify" } ] }, ) data = response.json()

<?php $ch = curl_init(); curl_setopt($ch, CURLOPT_URL, "https://api.triple-a.work/kyc-api/v1/customers/poi"); curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "POST"); curl_setopt($ch, CURLOPT_HTTPHEADER, ["Content-Type: application/json", "Authorization: Bearer <token>"]); curl_setopt($ch, CURLOPT_POSTFIELDS, '{ "files": [ { "customer_id": "6d282e8c-128e-4153-ad65-601930a94e02", "options": { "filename": "example.txt", "filetype": "text/plain" }, "notify_url": "https://example.com/notify" }, { "customer_id": "4d37cbdc-9dbb-4604-82a7-8f8753366a68", "options": { "filename": "example.jpeg", "filetype": "image/jpeg" }, "notify_url": "https://example.com/notify" } ] }'); $response = curl_exec($ch); curl_close($ch);

package main import ( "fmt" "io" "net/http" "strings" ) func main() { req, _ := http.NewRequest("POST", "https://api.triple-a.work/kyc-api/v1/customers/poi", strings.NewReader(`{ "files": [ { "customer_id": "6d282e8c-128e-4153-ad65-601930a94e02", "options": { "filename": "example.txt", "filetype": "text/plain" }, "notify_url": "https://example.com/notify" }, { "customer_id": "4d37cbdc-9dbb-4604-82a7-8f8753366a68", "options": { "filename": "example.jpeg", "filetype": "image/jpeg" }, "notify_url": "https://example.com/notify" } ] }`)) req.Header.Set("Content-Type", "application/json") req.Header.Set("Authorization", "Bearer <token>") resp, err := http.DefaultClient.Do(req) if err != nil { panic(err) } defer resp.Body.Close() data, _ := io.ReadAll(resp.Body) fmt.Println(string(data)) }

HttpClient client = HttpClient.newHttpClient(); HttpRequest request = HttpRequest.newBuilder() .uri(URI.create("https://api.triple-a.work/kyc-api/v1/customers/poi")) .header("Content-Type", "application/json") .header("Authorization", "Bearer <token>") .method("POST", HttpRequest.BodyPublishers.ofString("{\n \"files\": [\n {\n \"customer_id\": \"6d282e8c-128e-4153-ad65-601930a94e02\",\n \"options\": {\n \"filename\": \"example.txt\",\n \"filetype\": \"text/plain\"\n },\n \"notify_url\": \"https://example.com/notify\"\n },\n {\n \"customer_id\": \"4d37cbdc-9dbb-4604-82a7-8f8753366a68\",\n \"options\": {\n \"filename\": \"example.jpeg\",\n \"filetype\": \"image/jpeg\"\n },\n \"notify_url\": \"https://example.com/notify\"\n }\n ]\n}")) .build(); HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString()); System.out.println(response.body());

require "net/http" require "uri" uri = URI("https://api.triple-a.work/kyc-api/v1/customers/poi") http = Net::HTTP.new(uri.host, uri.port) http.use_ssl = uri.scheme == "https" request = Net::HTTP::Post.new(uri) request["Content-Type"] = "application/json" request["Authorization"] = "Bearer <token>" request.body = "{\n \"files\": [\n {\n \"customer_id\": \"6d282e8c-128e-4153-ad65-601930a94e02\",\n \"options\": {\n \"filename\": \"example.txt\",\n \"filetype\": \"text/plain\"\n },\n \"notify_url\": \"https://example.com/notify\"\n },\n {\n \"customer_id\": \"4d37cbdc-9dbb-4604-82a7-8f8753366a68\",\n \"options\": {\n \"filename\": \"example.jpeg\",\n \"filetype\": \"image/jpeg\"\n },\n \"notify_url\": \"https://example.com/notify\"\n }\n ]\n}" response = http.request(request) puts response.body

[ { "customer_id": "6d282e8c-128e-4153-ad65-601930a94e02", "options": { "filename": "example.txt", "filetype": "text/plain" }, "error_message": "Invalid File Extension" }, { "customer_id": "4d37cbdc-9dbb-4604-82a7-8f8753366a68", "options": { "filename": "example.jpeg", "filetype": "image/jpeg" }, "presigned_url": "https://<s3-url-to-upload-image>", "id": "82b786cd-c91e-40a7-8e06-db70e9a73787" } ]

{ "message": "error message about wrong data in request.body", "errors": [ { "path": "parameter with error", "message": "description of error", "errorCode": "openapi validation error code" } ] }