Skip to main content

Quick start

Welcome to quick guide on Card issuing. You will find here a 4 step instruction on how to issue a card using Antaca service with our sandbox environment. Set connection to our services following instructions described here. Once you receive your certificate from us, follow the steps below:

Our sandbox environment has a basic configuration allowing maintaining balances on the Verestro side, without protection for the bin-sponsor (masterbalance)

  1. Add user.

    Send POST request to /lifecycle/v1/wallet with user data (firstName, lastName, phone, email). You’ll receive customerID in return - it will be needed in further steps. Make sure you set value kyc = SUCCESS. It is necessary for further processes.


    example curl:
    curl -X POST 'https://lifecycle.upaidtest.pl/lifecycle/v1/wallet' \
    --cert /path/to/cert.pem \
    --key /path/to/key.pem:password \
    --header 'Content-Type: application/json' \
    --header 'Accept: application/json' \
    --header 'Issuer-Code: sandbox' \
    --header 'Application-Id: SBX-APP-ID' \
    --header 'Collection: lifecycle' \
    --data-raw '{
        "firstName": "John",
        "lastName": "Doe",
        "phone": "481234567899",
        "email": "john.doe@verestro.com",
        "birthDate": "2000-01-01",
        "wPIN": "1234",
        "state": "VERIFIED",
        "kyc": "SUCCESS"
    }'

  2. Create user verification form.

    Send POST request to /secure/customers/{customerId}/verification using customerID you’ve received in previous step. It will create KYC verification form.


    example curl:
    curl --location --request POST  'https://sandbox-antaca.secure-verestro.dev/secure/customers/{customerId}/verification' \
                                     --cert yourCertificate.crt:password \
                                     --key yourPrivate.key \
                                     --header 'Content-Type: multipart/form-data' \
                                     --header 'Accept: application/json' \
                                     --form 'firstName=Leon' \
                                     --form 'lastName=Bakiewicz' \
                                     --form 'imageFace=@/your/path/someFile.jpg' \
                                     --form 'street=Pieklo' \
                                     --form 'pesel=70010155587' \
                                     --form 'number=17a' \
                                     --form 'city=Lublin' \
                                     --form 'birthDate=1970-01-01' \
                                     --form 'postCode=20-128' \
                                     --form 'imageFront=@/your/path/someFile.jpg' \
                                     --form 'imageBack=@/your/path/someFile.jpg' \
                                     --form 'identityCardNo=ASD123456' \
                                     --form 'apartment=2' \
                                     --form 'documentType=passport' \
                                     --form 'country=PL' \
                                     --form 'documentExpirationDate=2025-01-30' \
                                     --form 'nationality=polish' \
                                     --form 'riskLvl=LOW'

  3. Create user balance.

    Send POST request to /secure/customers/{customerId}/balances. In response you will receive the balanceID with which you will be able to generate a card in the next step

    example curl:
    curl --location --request POST  'https://sandbox-antaca.secure-verestro.dev/secure/customers/{customerId}/balances' \
                                     --cert yourCertificate.crt:password \
                                     --key yourPrivate.key \
                                     --header 'Content-Type: application/json' \
                                     --header 'Accept: application/json' \
                                     --data-raw '{
                                        "currency": "EUR"
                                     }'


    if you are using IMS service, after the balance was created, the IBAN number will be generated automatically.


  4. Create new virtual card.

    Using customerID, balanceID and configID, send POST request to /secure/customers/{customerId}/cards/virtual.

    Single ConfigID contains information about the card type (virtual/physical), currency and bin range. You will receive it at the stage of configuring your project in Verestro. In the case of sandbox, please use 0019167984



    example curl:
    curl --location --request POST  'https://sandbox-antaca.secure-verestro.dev/secure/customers/{customerId}/cards/virtual' \
                                     --cert yourCertificate.crt:password \
                                     --key yourPrivate.key \
                                     --header 'Content-Type: application/json' \
                                     --header 'Accept: application/json' \
                                     --header 'Encrypted-Response: true' \
                                     --header 'Public-Key: {enduserPublicKey}' \
                                     --data-raw '{
                                        "balanceId": "0351eb09-3ac0-4234-a4ad-0a6ad52f248b",
                                        "configId": "0019167984"
                                     }'