Een identiteitsbewijs of adresbewijs koppelen

Voer deze stap uit nadat de identiteit of het adres is aangemaakt en de vereiste bestanden zijn geüpload via create_encrypt_files met het geselecteerde bewijstype. Gebruik een actuele identificatiecode uit get_proof_types, die overeenkomt met de vereiste en de entiteitscategorie.

Bewaar identity_id en address_id uit create_document; de UUID van het profiel is een andere identificatiecode. Of later een adresbewijs kan worden gekoppeld aan nieuw aangemaakte profielen, wordt nog onderzocht. Als het adres wordt afgewezen, raadpleeg dan de portal of de ondersteuning voordat u het opnieuw probeert.

Het bewijs aanmaken

Gebruik een geactiveerd MultiTEL-account voor de API en het daarvoor toegestane IP-adres. De voorbeelden gebruiken aanmeldgegevens voor HTTP Basic uit omgevingsvariabelen; volg de authenticatieregels voor uw accounttype. Verstuur verzoeken via HTTPS. Controleer zowel de HTTP-respons als het JSON-veld status.code; toepassingsfouten kunnen worden teruggegeven met HTTP 200. De onderstaande voorbeelden zijn fictief.

curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
  --header 'Content-Type: application/json' \
  --data @proof-request.json \
  https://api.multitel.net/v3/create_proof

{
  "entity_type": "identities",
  "entity_id": "33333333333333333333333333333333",
  "proof_type_id": "11111111111111111111111111111111",
  "encrypted_file_ids": [
    "22222222222222222222222222222222"
  ]
}

Verzoekvelden
Veld	Betekenis
`entity_type`	Gebruik identities of addresses. Kies de categorie die overeenkomt met zowel de doelentiteit als de geüploade bestanden.
`entity_id`	De identificatiecode van de identiteit of het adres dat bij uw account hoort. Gebruik de identificatiecode die tijdens uw documentproces is teruggegeven; vervang deze niet door een telefoonnummer of de identificatiecode van een niet-gerelateerd document.
`proof_type_id`	De identificatiecode van het geselecteerde bewijstype. Zorg dat deze overeenkomt met het type dat bij de upload is gebruikt en met de vereiste.
`encrypted_file_ids`	Een niet-lege JSON-array met bestandsidentificatiecodes die door create_encrypt_files zijn teruggegeven. De bestanden moeten bij hetzelfde account horen, mogen niet verlopen zijn en moeten overeenkomen met de entiteitscategorie. Dit is geen lijst met lokale bestandspaden.

Formuliergegevens worden ook geaccepteerd met herhaalde encrypted_file_ids[] velden. Gebruik bij voorkeur een echte JSON-array of een formulierarray; verstuur een als JSON gecodeerde array niet als een gewone scalaire formulierwaarde.

Bewaar de identificatiecode van het bewijs

{
  "status": {
    "code": 200,
    "msg": "Proof created successfully."
  },
  "response": {
    "id": "44444444444444444444444444444444",
    "entity_type": "identities",
    "entity_id": "33333333333333333333333333333333",
    "proof_type_id": "11111111111111111111111111111111",
    "proof_type_name": "Example identity proof"
  }
}

Een geslaagde respons bevestigt dat de koppeling met het bewijs is aangemaakt. Dit bevestigt niet dat de identiteit of het adres is goedgekeurd, dat is gecontroleerd of aan alle vereisten van het land is voldaan, of dat een telefoonnummer is geactiveerd.

Fouten en verlopen uploads

API-code 500 wordt gebruikt bij ontbrekende verplichte invoer, storingen bij de telecomaanbieder en een ongeldige respons van de telecomaanbieder. Code 404 wordt gebruikt als de doelentiteit niet aan het huidige account is gekoppeld, het bewijstype ongeldig is, een geüpload bestand niet kan worden gevonden voor dit account en deze categorie of is verlopen, of als er geen bruikbare bestandsidentificatiecodes overblijven. Lees status.msg samen met de code.

Upload een verlopen verplicht bestand opnieuw met de juiste bewijscategorie voordat u het koppelt. Als een van de opgegeven bestanden ongeldig is, stopt deze handler voordat het verzoek om het bewijs aan te maken wordt verstuurd. Er is geen idempotentiesleutel beschikbaar: controleer na een time-out het bestaande document in de portal voordat u de koppeling opnieuw uitvoert.