Registration

👍
To begin issuing cards, an integrator needs to be registered for this service. They also need to register any user that they would be issuing these cards.

Integrator Registration

Provide authentication credentials to register.
The contact person for your company will provide their email address and phone number.
For the business itself, you will provide a business address, company url, and another url where we can deliver your webhook notifications. Be sure that your webhook URL can accept a POST call with a JSON body.

Make a POST/card-integrators/register-integrator API call.

curl --location --request POST 'https://api-sandbox.spendjuice.com/card-integrators/register-integrator' \
--header 'Content-Type: application/json' \
--data-raw '{
 		"business_address": {
    "city": "Lagos",
    "country": "NGA",
    "line1": "1 Ademola Tokunbo Str",
    "line2": "suite 206",
    "state": "Lagos",
    "zip_code": "1071233"
    },
    "business_name": "Card issuance company",
    "chain": "SOL",
    "contact_number": "+2349022542677",
    "country": "NG",
    "domain": "https://cardcompany.com",
    "email": "issuance@cardcompany.com",
    "first_name": "Card",
    "last_name": "Company",
    "float_currencies": ["USD"],
    "password": "P@ssw0rd!",
    "registration_number": "1277738",
    "webhook_url": "https://sandbox.cardcompany.com"
}'

{
    "data": {
 				"business_address": {
        "city": "Lagos",
        "country": "NGA",
        "line1": "1 Ademola Tokunbo Str",
        "line2": "suite 206",
        "state": "Lagos",
        "zip_code": "1071233"
        },
        "business_name": "Card issuance company",
        "chain": "SOL",
        "contact_number": "+2349022542677",
        "country": "NG",
        "domain": "https://cardcompany.com",
        "email": "issuance@cardcompany.com",
        "first_name": "Card",
        "float_currencies": [
            "USD"
        ],
        "id": "3d6281d3-4875-4a40-8d51-cdbf6eb95345",
        "last_name": "Company",
        "registration_number": "1277738",
        "usdc_address": {
            "address": "AMaGFhTaFu1Kia1MRrh5YNcmFqnEoWEEKAuJDyAPZJJL",
            "chain": "SOL",
            "currency": "USD"
        }
    }
}

Upon registering, you'd use our authentication to generate a token to access this service. This endpoint can also be used to regenerate a token whenever necessary.

👍
If the need arises to update information about an integrator, use the /card-integrators/update endpoint to make changes.

User Registration

A prerequisite to issuing a card to a user is registration. Certain authentication credentials need to be provided for the user, just like in the case of registering an integrator. User registration requires that a valid residential address for the user, email address and ID number are provided, as seen in the sample request below.

Registering non-african users
In addition to all data required for user registration, you are to provide a Base64 image of non-african users being registered.

PATH Parameters	BODY Parameters	Registering African users	Registering non-african users
Card integrator id		yes	yes
	Address: city, country,line1, line2, state, zip_code	yes	yes
	Email	yes	yes
	First Name	yes	yes
	Last Name	yes	yes
	ID Number	yes	yes
	ID Type	yes	yes
	Phone number	yes	yes
	User photo	no	yes

Use the endpoint as seen in the sample below

curl --location --request POST 'https://api-sandbox.spendjuice.com/card-integrators/a828acfc-b3d5-400d-a769-da769493e154/register-user' \
--header 'Authorization: Bearer eyJhbGciOiJIUzUxMiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJqdWljZSIsImV4cCI6MTY1MjU0NDI3NSwiaWF0IjoxNjM2OTkyMjc1LCJpc3MiOiJqdWljZSIsImp0aSI6ImFhYTEyNzlhLTZhYmYtNGVlYS05MzMyLTZjMzc2NTI2YTE0NSIsIm5iZiI6MTYzNjk5MjI3NCwic3ViIjoiY2FyZC1pbnRlZ3JhdG9yOmE4MjhhY2ZjLWIzZDUtNDAwZC1hNzY5LWRhNzY5NDkzZTE1NCIsInR5cCI6ImFjY2VzcyJ9.Waev-U_fRgckBOmQIE20K0vs7zm_L19LRpaPIhihWH1D8RL_PNaQ7d-X_iS3qGjumBG1u_meVCpsCOh0d0-hMg' \
--header 'Content-Type: application/json' \
--data-raw '{
    "address": {
        "city": "ibadan",
        "country": "NGA",
        "line1": "eleyele",
        "zip_code": "101111"
    },
    "email": "crypto.user@juiceafrica.com",
    "first_name": "Crypto",
    "last_name": "User",
    "id_number": "00000000000",
    "id_type": "BVN",
    "phone_number": "+2347089671405"
}'

When a user is registered, the verification status would be false, When verification is complete, the integrator would receive a webhook notifying them.

{
    "data": {
        "address": {
            "city": "ibadan",
            "country": "NGA",
            "line1": "eleyele",
            "line2": null,
            "state": null,
            "zip_code": "101111"
        },
        "archived": false,
        "card_integrator_id": "3d6281d3-4875-4a40-8d51-cdbf6eb95345",
        "email": "card.user@cardcompany.com",
        "first_name": "Card",
        "id": "14f973b1-ce52-4ada-926d-0c26e02692f3",
        "id_number": "00000000000",
        "id_type": "BVN",
        "last_name": "User",
        "phone_number": "+2347089671405",
        "verified": false
    }
}