Skip to main content

Documentación

Creación de una billetera Rapyd

Cree una arquitectura de cartera potente. | Empresarial

Una billetera Rapyd es un lugar donde guardar fondos mientras aceptas pagos, depositas fondos y emites tarjetas. Rapyd permite a los clientes emitir carteras a consumidores y empresas para gestionar el flujo de fondos que entran y salen de su ecosistema

Las carteras emitidas para sus clientes comerciales usarán tipo: empresa. Una empresa puede permitir que más de un contacto esté vinculado a una billetera.

Las carteras emitidas para sus consumidores usarán tipo: persona. Una billetera personal solo permite un contacto por billetera.

creating-a-wallet.jpg
  1. Le pides al cliente su información

  2. El cliente proporciona su información de contacto.

  3. El back-end de su sitio web le pide a Rapyd que cree una billetera para el cliente

  4. Rapyd regresa con un monedero personal y te envía un webhook.

  5. Comienzas el proceso para verificar al cliente a través de Verificación de identidad.

Próximos pasos: verificar la identidad

Deberás verificar la identidad del cliente a través de los documentos requeridos relevantes para el país del cliente, tal como se describe en Verificación de identidad.

Los siguientes diagramas de secuencia de mensajes describen cómo se intercambia la información entre Rapyd, el comerciante y los clientes del comerciante.

Crear billetera

create-wallet-message-sequence.svg

Para crear una billetera Rapyd, utilizarás Crea un monedero con los siguientes parámetros:

Descripción de los parámetros

Parámetro corporal

Descripción

contacto

Describe los detalles sobre los contactos de la cartera. Conjunto de objetos.

correo electrónico

Dirección de correo electrónico del propietario del monedero.

id_de referencia_de_billetera electrónica

ID de Rapyd Wallet definido por el cliente o usuario final. Debe ser único

nombre_de_pila

Nombre del propietario de Rapyd Wallet.

apellido_nombre

Apellido del propietario de Rapyd Wallet.

metadatos

Un objeto JSON definido por el cliente.

tipo

Tipo de cartera: empresa o persona. El valor predeterminado es persona.

    • Solicitud

      • {
            "first_name": "Samson",
            "last_name": "Smith",
            "email": "",
            "ewallet_reference_id": "Samson-Smith-09232021",
            "metadata": {
                "merchant_defined": true
            },
            "phone_number": "5555555555",
            "type": "person",
            "contact": {
                "phone_number": "+14155551311",
                "email": "samson@rapyd.net",
                "first_name": "Samson",
                "last_name": "Smith",
                "mothers_name": "Jane Smith",
                "contact_type": "personal",
                "address": {
                    "name": "Samson Smith",
                    "line_1": "123 Main Street",
                    "line_2": "",
                    "line_3": "",
                    "city": "Anytown",
                    "state": "NY",
                    "country": "US",
                    "zip": "12345",
                    "phone_number": "+14155551111",
                    "metadata": {},
                    "canton": "",
                    "district": ""
                },
                "identification_type": "PA",
                "identification_number": "1234567890",
                "date_of_birth": "11/22/2000",
                "country": "US",
                "nationality": "US",
                "metadata": {
                    "merchant_defined": true
                }
            }
        }

El datos La sección de esta solicitud muestra el tipo de billetera que se puede crear. Solo hay tres tipos de carteras: persona, empresa y cliente. El objeto de cartera se describe con los siguientes parámetros:

  • El número_teléfono es 5555555555.

  • El ewallet_reference_id es Samson-Smith - 0923 2021.

  • El contactonombre_de_pila y apellido_nombre es SansónSmith.

    • Respuesta

      • {
            "status": {
                "error_code": "",
                "status": "SUCCESS",
                "message": "",
                "response_code": "",
                "operation_id": "466d421d-d20e-4d4b-8702-a64d7995b707"
            },
            "data": {
                "phone_number": "5555555555,
                "email": null,
                "first_name": "Samson",
                "last_name": "Smith",
                "id": "ewallet_54d53f5dd6dbb23d74c1f9807603180c",
                "status": "ACT",
                "accounts": [],
                "verification_status": "not verified",
                "type": "person",
                "metadata": {
                    "merchant_defined": true
                },
                "ewallet_reference_id": "Samson-Smith-10272021",
                "category": null,
                "contacts": {
                    "data": [
                        {
                            "id": "cont_590315fa4e0c08357e794284fac95bdd",
                            "first_name": "Samson",
                            "last_name": "Smith",
                            "middle_name": "",
                            "second_last_name": "",
                            "gender": "not_applicable",
                            "marital_status": "not_applicable",
                            "house_type": "",
                            "contact_type": "personal",
                            "phone_number": "+14155551311",
                            "email": "samson@rapyd.net",
                            "identification_type": "PA",
                            "identification_number": "1234567890",
                            "issued_card_data": {
                                "preferred_name": "",
                                "transaction_permissions": "",
                                "role_in_company": ""
                            },
                            "date_of_birth": "2000-11-22",
                            "country": "US",
                            "nationality": "US",
                            "address": {
                                "id": "address_6f2e5e5bcf528b1c629361c9c68d5589",
                                "name": "Samson Smith",
                                "line_1": "123 Main Street",
                                "line_2": "",
                                "line_3": "",
                                "city": "Anytown",
                                "state": "NY",
                                "country": "US",
                                "zip": "12345",
                                "phone_number": "+14155551111",
                                "metadata": {},
                                "canton": "",
                                "district": "",
                                "created_at": 1635375280
                            },
                            "ewallet": "ewallet_54d53f5dd6dbb23d74c1f9807603180c",
                            "created_at": 1635375280,
                            "metadata": {
                                "merchant_defined": true
                            },
                            "business_details": null,
                            "compliance_profile": 0,
                            "verification_status": "not verified",
                            "send_notifications": false,
                            "mothers_name": "Jane Smith"
                        }
                    ],
                    "has_more": false,
                    "total_count": 1,
                    "url": "/v1/ewallets/ewallet_54d53f5dd6dbb23d74c1f9807603180c/contacts"
                }
            }
        }

El datos la sección de esta solicitud muestra la billetera electrónica que se creó.

  • El contacto identificador de objeto cont_590315fa4e0c08357e794284fac95bdd y Samson Smith. Los campos se describen en Objeto de contacto de la billetera.

  • El identificador de la billetera electrónica es ewallet_54d53f5dd6dbb23d74c1f9807603180c