Files & KYC
Upload file details and binary data to storage.
POST /v1/consumer/admin/files/{consumerReference}
Auth: API key (VantagePayAdminClient).
Parameters
| Name | In | Required | Description |
|---|---|---|---|
consumerReference | path | Yes | A globally unique internal consumer reference (UUID). |
Request body
| Field | Type | Required | Description |
|---|---|---|---|
fileType | one of 14 values (e.g. Unspecified, FaceImage, IdentityDocumentFront, ...) | No | The KYC-specific file type that categorizes this document (e.g. national ID, passport, proof of address). |
kycResults | array<object>? | No | The KYC verification results associated with this file from one or more KYC providers. |
reference | string? | No | The system-assigned unique reference (UUID) for this file record. |
yourReference | string? | No | An optional external reference from the caller's system that identifies this file. |
description | string? | No | An optional human-readable description of the file contents. |
fileName | string? | No | The original file name including extension (e.g. "id_document.pdf"). |
mimeType | string? | No | The MIME type of the file, resolved from the file extension (e.g. "application/pdf"). |
base64Data | string? | No | The base64-encoded file content. Populated only when uploading or explicitly requested. |
createdDate | string | No | The UTC date and time at which this file was uploaded. |
lastUpdatedDate | string? | No | The UTC date and time at which this file was last updated. |
isActive | boolean | No | true if this file is currently active and visible. |
json
{
"fileType": "Unspecified",
"kycResults": [
{}
],
"reference": "00000000-0000-0000-0000-000000000000",
"yourReference": "string",
"description": "string",
"fileName": "string",
"mimeType": "string",
"base64Data": "string",
"createdDate": "string",
"lastUpdatedDate": "string",
"isActive": true
}Responses
| Status | Description |
|---|---|
200 | The request was successful but does not return any results. |
400 | The request failed validation, the error object will contain further information. |
401 | The authorization information provided is not valid, authentication is required to access this resource. |
403 | The authorization header does not contain the correct type or you do not have access to this resource. |
404 | The request was successful but does not return any results. |
422 | The request payload is invalid, the error object will contain further information. |
429 | Too many requests are being sent concurrently or rate limiting has taken effect. |
500 | An unexpected error occurred, the error object will contain further information. |
Response body
| Field | Type | Required | Description |
|---|---|---|---|
success | boolean | No | Gets a value indicating whether the operation was successful. |
result | object | No | A file attached to a consumer record, such as a proof of identity or supporting KYC document. |
json
{
"success": true,
"result": {
"fileType": "Unspecified",
"kycResults": [],
"reference": "00000000-0000-0000-0000-000000000000",
"yourReference": "string",
"description": "string",
"fileName": "string",
"mimeType": "string",
"base64Data": "string",
"createdDate": "string",
"lastUpdatedDate": "string",
"isActive": true
}
}Code samples
WARNING
The JavaScript SDK does not cover admin APIs - use the .NET SDK.
csharp
using VantagePay.Models.Consumers;
var file = await adminClient.Consumers.UploadFileAsync(Guid.Parse("7c9e6679-7425-40de-944b-e07fc1f90ae7"), new ConsumerFile
{
FileName = "id-document.pdf",
FileType = ConsumerFileType.IdentityDocumentFront,
Base64Data = documentBase64, // must be <= 4 MB
});Get file details and it's binary data from storage.
GET /v1/consumer/admin/files/{consumerReference}/{fileReference}
Auth: API key (VantagePayAdminClient).
Parameters
| Name | In | Required | Description |
|---|---|---|---|
consumerReference | path | Yes | A globally unique internal consumer reference (UUID). |
fileReference | path | Yes | A globally unique internal file reference (UUID). |
Responses
| Status | Description |
|---|---|
200 | The request was successful but does not return any results. |
400 | The request failed validation, the error object will contain further information. |
401 | The authorization information provided is not valid, authentication is required to access this resource. |
403 | The authorization header does not contain the correct type or you do not have access to this resource. |
404 | The request was successful but does not return any results. |
422 | The request payload is invalid, the error object will contain further information. |
429 | Too many requests are being sent concurrently or rate limiting has taken effect. |
500 | An unexpected error occurred, the error object will contain further information. |
Response body
| Field | Type | Required | Description |
|---|---|---|---|
success | boolean | No | Gets a value indicating whether the operation was successful. |
result | object | No | A file attached to a consumer record, such as a proof of identity or supporting KYC document. |
json
{
"success": true,
"result": {
"fileType": "Unspecified",
"kycResults": [],
"reference": "00000000-0000-0000-0000-000000000000",
"yourReference": "string",
"description": "string",
"fileName": "string",
"mimeType": "string",
"base64Data": "string",
"createdDate": "string",
"lastUpdatedDate": "string",
"isActive": true
}
}Code samples
WARNING
The JavaScript SDK does not cover admin APIs - use the .NET SDK.
csharp
var file = await adminClient.Consumers.DownloadFileAsync(Guid.Parse("7c9e6679-7425-40de-944b-e07fc1f90ae7"), Guid.Parse("99998888-7777-6666-5555-444433332211"));Delete file details.
DELETE /v1/consumer/admin/files/{consumerReference}/{fileReference}
Auth: API key (VantagePayAdminClient).
Parameters
| Name | In | Required | Description |
|---|---|---|---|
consumerReference | path | Yes | A globally unique internal consumer reference (UUID). |
fileReference | path | Yes | A globally unique internal file reference (UUID). |
Responses
| Status | Description |
|---|---|
200 | The request was successful but does not return any results. |
400 | The request failed validation, the error object will contain further information. |
401 | The authorization information provided is not valid, authentication is required to access this resource. |
403 | The authorization header does not contain the correct type or you do not have access to this resource. |
404 | The request was successful but does not return any results. |
422 | The request payload is invalid, the error object will contain further information. |
429 | Too many requests are being sent concurrently or rate limiting has taken effect. |
500 | An unexpected error occurred, the error object will contain further information. |
Response body
| Field | Type | Required | Description |
|---|---|---|---|
success | boolean | No | Gets a value indicating whether the operation was successful. |
json
{
"success": true
}Code samples
WARNING
The JavaScript SDK does not cover admin APIs - use the .NET SDK.
csharp
await adminClient.Consumers.DeleteFileAsync(Guid.Parse("7c9e6679-7425-40de-944b-e07fc1f90ae7"), Guid.Parse("99998888-7777-6666-5555-444433332211"));Manually verify the consumer KYC status.
PUT /v1/consumer/admin/kyc/verify/{consumerReference}
Auth: API key (VantagePayAdminClient).
Parameters
| Name | In | Required | Description |
|---|---|---|---|
consumerReference | path | Yes | A globally unique internal consumer reference (UUID). |
Responses
| Status | Description |
|---|---|
200 | The request was successful but does not return any results. |
400 | The request failed validation, the error object will contain further information. |
401 | The authorization information provided is not valid, authentication is required to access this resource. |
403 | The authorization header does not contain the correct type or you do not have access to this resource. |
404 | The request was successful but does not return any results. |
422 | The request payload is invalid, the error object will contain further information. |
429 | Too many requests are being sent concurrently or rate limiting has taken effect. |
500 | An unexpected error occurred, the error object will contain further information. |
Response body
| Field | Type | Required | Description |
|---|---|---|---|
success | boolean | No | Gets a value indicating whether the operation was successful. |
json
{
"success": true
}Code samples
WARNING
The JavaScript SDK does not cover admin APIs - use the .NET SDK.
csharp
await adminClient.Consumers.VerifyKycAsync(Guid.Parse("7c9e6679-7425-40de-944b-e07fc1f90ae7"));Manually reject a consumer KYC status.
PUT /v1/consumer/admin/kyc/reject/{consumerReference}
Auth: API key (VantagePayAdminClient).
Parameters
| Name | In | Required | Description |
|---|---|---|---|
consumerReference | path | Yes | A globally unique internal consumer reference (UUID). |
Responses
| Status | Description |
|---|---|
200 | The request was successful but does not return any results. |
400 | The request failed validation, the error object will contain further information. |
401 | The authorization information provided is not valid, authentication is required to access this resource. |
403 | The authorization header does not contain the correct type or you do not have access to this resource. |
404 | The request was successful but does not return any results. |
422 | The request payload is invalid, the error object will contain further information. |
429 | Too many requests are being sent concurrently or rate limiting has taken effect. |
500 | An unexpected error occurred, the error object will contain further information. |
Response body
| Field | Type | Required | Description |
|---|---|---|---|
success | boolean | No | Gets a value indicating whether the operation was successful. |
json
{
"success": true
}Code samples
WARNING
The JavaScript SDK does not cover admin APIs - use the .NET SDK.
csharp
await adminClient.Consumers.RejectKycAsync(Guid.Parse("7c9e6679-7425-40de-944b-e07fc1f90ae7"));