Skip to main content

Documentation

Add Contact to Wallet
  • Add a personal contact to a company wallet or client wallet.

  • This page also includes details on the required parameters for a business contact_type that should be added when creating a company wallet:

    • address

    • business_details

    • country

Note

  • For best practices, include the first_name, last_name, date_of_birth, country, address.name and address.line_1 fields. These fields are required for other operations.

  • You can only add a personal contact to a company wallet or a client wallet.

  • To change parameter values of a wallet contact, see Update Wallet Contact.

    • wallet

    • ID of the Rapyd Wallet that this contact is associated with. String starting with ewallet_.

  • /v1/ewallets/:wallet/contacts

  • Add Contact to Wallet

  • curl -X post 'https://sandboxapi.rapyd.net/v1/ewallets/ewallet_b5320c566cc4aa01fe77440ad08693f7/contacts' \
    -H 'access_key: your-access-key-here' \
    -H 'Content-Type: application/json' \
    -H 'idempotency: your-idempotency-parameter-here' \
    -H 'salt: your-random-string-here' \
    -H 'signature: your-calculated-signature-here' \
    -H 'timestamp: your-unix-timestamp-here'
    --data-raw '{
        "first_name": "Jane",
        "last_name": "Doe",
        "contact_type": "personal",
        "identification_type": "PA",
        "identification_number": "1233242424",
        "country": "US",
        "address": {
            "name": "Jane Doe",
            "line_1": "123 Lake Forest Drive",
            "line_2": "",
            "line_3": "",
            "city": "Anytown",
            "state": "NY",
            "zip": "12345",
            "phone_number": "+14155551234",
            "metadata": {
                "merchant_defined": true
            },
            "canton": "",
            "district": ""
        }
    }'
    
  • {
        "status": {
            "error_code": "",
            "status": "SUCCESS",
            "message": "",
            "response_code": "",
            "operation_id": "cda4e4c2-afd5-430c-bbc6-8ed79bfe8afc"
        },
        "data": {
            "id": "cont_6b37bac42846c7046bdb9e24b89a5d05",
            "first_name": "Jane",
            "last_name": "Doe",
            "middle_name": "",
            "second_last_name": "",
            "gender": "not_applicable",
            "marital_status": "not_applicable",
            "house_type": "",
            "contact_type": "personal",
            "phone_number": "",
            "email": "",
            "identification_type": "PA",
            "identification_number": "1233242424",
            "issued_card_data": {
                "preferred_name": "",
                "transaction_permissions": "",
                "role_in_company": ""
            },
            "date_of_birth": null,
            "country": "US",
            "nationality": null,
            "address": {
                "id": "address_2c98c788eafe3a5a6b7541431e0ced5e",
                "name": "Jane Doe",
                "line_1": "123 Lake Forest Drive",
                "line_2": "",
                "line_3": "",
                "city": "Anytown",
                "state": "NY",
                "country": "",
                "zip": "12345",
                "phone_number": "+14155551234",
                "metadata": {
                    "merchant_defined": true
                },
                "canton": "",
                "district": "",
                "created_at": 1754572956
            },
            "ewallet": "ewallet_b5320c566cc4aa01fe77440ad08693f7",
            "created_at": 1754572956,
            "metadata": {},
            "business_details": null,
            "compliance_profile": 0,
            "verification_status": "not verified",
            "send_notifications": false,
            "mothers_name": "",
            "contact_reference_id": null
        }
    }