Tarjetas Virtuales

Registro de Clientes para la Creación de Tarjetas Virtuales

Antes de que un cliente pueda crear una tarjeta virtual, debe estar registrado y activado para este servicio. Este registro implica proporcionar información específica y completar una solicitud de activación a través del endpoint {{baseUrl}}/customer/virtual/cards/activate. A continuación, se detallan los datos necesarios y los pasos para este proceso.

Soportamos todos los países y tenemos diferentes tipos de identificación (IDType) para ciertos países; aquí está la lista:

Países	Documentos Aceptados
Nigeria	[vNIN, PASAPORTE, LICENCIA_DE_CONDUCIR, PVC]
Ghana	[PASAPORTE, LICENCIA_DE_CONDUCIR, ID_DE_VOTANTE]
Kenia	[PASAPORTE, ID_NACIONAL]
Senegal	[ID_NACIONAL, ID_ECOWAS]
Otros Países	[ID_NACIONAL]

Información Requerida para el Registro

Para registrar a un cliente para la creación de una tarjeta virtual, se necesita la siguiente información:

• customerId: Identificador único del cliente.

• customerEmail: Correo electrónico del cliente.

• idNumber: Número de identificación del cliente.

• idType: Tipo de identificación (por ejemplo, pasaporte, licencia de conducir).

• firstName: Nombre del cliente.

• dateOfBirth: Fecha de nacimiento del cliente.

• lastName: Apellido del cliente.

• phoneNumber: Número de teléfono del cliente.

• city: Ciudad de residencia.

• state: Estado de residencia.

• country: País de residencia en formato ISO3.

• zipCode: Código postal.

• line1: Dirección (línea 1).

• houseNumber: Número de casa o apartamento.

• idImage: URL de la imagen del documento de identificación.

Proceso de Solicitud de Activación

1. Recolectar Información del Cliente: Reúne toda la información requerida listada anteriormente del cliente.

2. Enviar Solicitud de Activación: Realiza una solicitud POST al endpoint {{baseUrl}}/customer/virtual/cards/activate con la información recolectada en el cuerpo de la solicitud.

Ejemplo de Payload de Solicitud

A continuación se muestra un ejemplo de cómo debe estructurarse el payload de la solicitud:

{
  "customerId": "123456789",
  "customerEmail": "[e-mail]",
  "idNumber": "A12345678",
  "idType": "passport",
  "firstName": "John",
  "lastName": "Doe",
  "dateOfBirth": "YYYY-MM-DD",
  "phoneNumber": "[phone]",
  "city": "New York",
  "state": "NY",
  "country": "USA",
  "zipCode": "10001",
  "line1": "123 Main St",
  "houseNumber": "456",
  "idImage": "https://example.com/id_image.jpg"
}

Python

import requests
import json

url = '{{baseUrl}}/customer/virtual/cards/activate'
payload = {
    'customerId': '123456789',
    'customerEmail': '[e-mail]',
    'idNumber': 'A12345678',
    'idType': 'passport',
    'firstName': 'John',
    'lastName': 'Doe',
    'dateOfBirth': 'YYYY-MM-DD',
    'phoneNumber': '[phone]',
    'city': 'New York',
    'state': 'NY',
    'country': 'USA',
    'zipCode': '10001',
    'line1': '123 Main St',
    'houseNumber': '456',
    'idImage': 'https://example.com/id_image.jpg'
}
headers = {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9'
}

response = requests.post(url, headers=headers, data=json.dumps(payload))

print(response.json())

PHP

<?php
$url = '{{baseUrl}}/customer/virtual/cards/activate';
$payload = json_encode(array(
    'customerId' => '123456789',
    'customerEmail' => '[e-mail]',
    'idNumber' => 'A12345678',
    'idType' => 'passport',
    'firstName' => 'John',
    'lastName' => 'Doe',
    'dateOfBirth' => 'YYYY-MM-DD',
    'phoneNumber' => '[phone]',
    'city' => 'New York',
    'state' => 'NY',
    'country' => 'USA',
    'zipCode' => '10001',
    'line1' => '123 Main St',
    'houseNumber' => '456',
    'idImage' => 'https://example.com/id_image.jpg'
));

$headers = array(
    'Content-Type: application/json',
    'Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9'
);

$curl = curl_init();

curl_setopt_array($curl, array(
    CURLOPT_URL => $url,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_ENCODING => '',
    CURLOPT_MAXREDIRS => 10,
    CURLOPT_TIMEOUT => 0,
    CURLOPT_FOLLOWLOCATION => true,
    CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_POSTFIELDS => $payload,
    CURLOPT_HTTPHEADER => $headers,
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;
?>

JavaScript

const url = '{{baseUrl}}/customer/virtual/cards/activate';
const payload = JSON.stringify({
  customerId: '123456789',
  customerEmail: '[e-mail]',
  idNumber: 'A12345678',
  idType: 'passport',
  firstName: 'John',
  lastName: 'Doe',
  dateOfBirth: 'YYYY-MM-DD',
  phoneNumber: '[phone]',
  city: 'New York',
  state: 'NY',
  country: 'USA',
  zipCode: '10001',
  line1: '123 Main St',
  houseNumber: '456',
  idImage: 'https://example.com/id_image.jpg'
});

const options = {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9'
  },
  body: payload
};

fetch(url, options)
  .then(response => {
    if (!response.ok) {
      throw new Error('Network response was not ok');
    }
    return response.json();
  })
  .then(data => console.log(data))
  .catch(error => console.error('Error:', error));

Ejemplo de Respuesta

Después de una activación exitosa, la API responderá con un mensaje de confirmación y un código de estado. Aquí hay un ejemplo de respuesta:

{
  "status": "success",
  "message": "Virtual card service activated successfully.",
  "activationDate": "2024-05-29T12:34:56Z"
}

Consideraciones Importantes

• Validación de Datos: Asegúrate de que toda la información proporcionada sea precisa y válida. Los detalles incorrectos pueden resultar en un fallo de activación.

• Seguridad: Maneja de manera segura todos los datos del cliente, especialmente la información sensible como la imagen del documento de identificación y los identificadores personales. Usa protocolos de comunicación seguros y cifrado.

• Verificaciones de Elegibilidad: El sistema puede realizar verificaciones adicionales para comprobar la elegibilidad del cliente para la activación de la tarjeta virtual. Esto puede incluir el cumplimiento de KYC, la verificación del estado de la cuenta y medidas de prevención de fraudes.

Siguiendo estos pasos y asegurando que toda la información necesaria se proporcione correctamente, los clientes pueden ser registrados y activados con éxito para la creación de tarjetas virtuales.