Virtual Card Service

Introduction

Instead of issuing vouchers on paper when customers returns items or issuing plastic gift cards, you can issue virtual cards that can be used in all channels. Virtual cards will have balance and expiring dates.

Creating new virtual card when customers returns some items or buying a Gift card:

1. You can create a new card by using endpoint here: https://docs.dintero.com/api.html#operation/aid_cards_post In this example we are creating a Voucher with amount of NOK 500,00 that will expire in 1 year with a token that has prefix VOUCH: and length of 16 digits

{
    "metadata": {
        "order_id": "xk39592f",
        "return_reason": "not happy with the jacket"
    },
    "amount": 50000,
    "currency": "NOK",
    "card_id": "e1f114e5-e295-4e28-9dcb-6eb361288712",
    "customer_id": "3288922",
    "expires_at": "2019-08-24T14:15:22Z",
    "card_token": {
        "format": {
            "length": 16,
            "prefix": "VOUCH:",
            "symbols": false,
            "numbers": true,
            "characters": false,
            "barcode": true
        },
        "expires_after_transaction": false,
        "expires_in": 31536000
    }
}

Response:

{
    "id": "fd194162-e550-4ef7-8414-f20b3d74eae4",
    "card_id": "e1f114e5-e295-4e28-9dcb-6eb361288712",
    "customer_id": "3288922",
    "expires_at": "2019-08-24T14:15:22.000Z",
    "metadata": {
        "order_id": "xk39592f",
        "return_reason": "not happy with the jacket"
    },
    "created_by": "7b9d0039-ee37-43aa-ba48-e018659399fc",
    "created_at": "2022-11-11T17:12:25.288Z",
    "amount": 50000,
    "currency": "NOK",
    "amount_available": 50000,
    "amount_balance": 50000,
    "card_token": {
        "id": "262d6039-838e-4356-a976-466e8e89aa40",
        "ref_id": "e1f114e5-e295-4e28-9dcb-6eb361288712",
        "created_at": "2022-11-11T17:12:25.288Z",
        "created_by": "7b9d0039-ee37-43aa-ba48-e018659399fc",
        "expires_in": 31536000,
        "expires_after_transaction": false,
        "metadata": {},
        "format": {
            "qr": false,
            "length": 16,
            "prefix": "VOUCH:",
            "barcode": true,
            "numbers": true,
            "symbols": false,
            "characters": false
        },
        "token": {
            "barcode_128": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAaQAAACOCAYAAAB+DHzRAAAABmJLR0QA/wD/AP+gvaeTAAAS4UlEQVR4nO3caUxUZ/sG8OsAwiADyNK6ixUXVFCqVq0koqBiXXChWrW1bsQ1TfCDuBTTpDZt9Y1WbbXE1LoltS6VNLhQcMOl7satIu67xh0VWeX+f2jmlHFmnDkD/fu8b65fwod5znPu85zzjHPNnEVNRARERERvmMebHgARERHAQCIiIkUwkIiISAkMJCIiUgIDiYiIlMBAIiIiJTCQiIhICQwkIiJSAgOJiIiU4OVqR03TrF5b/oMHS/ur/+GDo3ZndZ3VdzQOR3WdLXe2XXfb3V1eXftT1eNV1ePnbNyuvp/cPa6u1nV1XI4Y3b677c7qVve8Gj0u1T0Pzrb7b/17c3d7ztZ3xN33pbP6rn5uGv18cLR9dz+nX8VfSEREpAQGEhERKYGBRERESmAgERGREhhIRESkBAYSEREpgYFERERKYCAREZESGEhERKQEBhIRESmBgUREREpgIBERkRIYSEREpAQGEhERKYGBRERESmAgERGREhhIRESkBAYSEREpgYFERERKYCAREZESGEhERKQEBhIRESmBgUREREpgIBERkRIYSEREpAQGEhERKYGBRERESmAgERGREhhIRESkBAYSEREpgYFERERKYCAREZESGEhERKQEBhIRESmBgUREREpgIBERkRIYSEREpAQGEhERKYGBRERESmAgERGREhhIRESkBAYSEREpgYFERERKYCAREZESGEhERKQEBhIRESmBgUREREpgIBERkRIYSEREpAQGEhERKYGBRERESmAgERGREhhIRESkBAYSEREpgYFERERKYCAREZESGEhERKQEBhIRESmBgUREREpgIBERkRIYSEREpAQGEhERKYGBRERESmAgERGREhhIRESkBAYSEREpgYFERERKYCAREZESGEhERKQEBhIRESmBgUREREpgIBERkRIYSEREpAQGEhERKYGBRERESmAgERGREhhIRESkBAYSEREpgYFERERKYCAREZESGEhERKQEBhIRESmBgUREREpgIBERkRIYSEREpAQGEhERKYGBRERESmAgERGREhhIRESkBAYSEREpgYFERERKYCAREZESGEhERKQEBhIRESmBgUREREpgIBERkRIYSEREpAQGEhERKYGBREREStBERN70IIiIiPgLiYiIlMBAIiIiJTCQiIhICQwkIiJSAgOJiIiUwEAiIiIlMJCIiEgJDCQ3bdu2DZqmoVevXg77JCYmQtM0bNiwwap948aNiImJgdlshtlsxvvvv4+1a9farD916lRomoYffvjBZtnKlSuhaRomTZpks6yiogIrVqxAbGwsatWqBV9fX0RERGDKlCk4f/683m/48OHQNA0bN260qZGVlQVN09C/f//XHgdXPH78GDNmzECLFi3g6+uLkJAQxMTE4JdffrHqd+/ePUyfPh1du3ZFvXr1YDKZ0KRJEyQmJmLnzp12az979gypqalo2rQpvL29ERQUhISEBOzevdtu/4MHDyI1NRXdunVDQEAANE3D8OHDHY7daP3S0lLMnTsXHTp0QHBwMGrVqoXo6Gj85z//QWFhod119uzZg/j4ePj7+8NsNqN79+7YtWuX3b41atSApml2/9LT06s0/pEjRzqsbfmbNWuW2+NxZ36NzJfR+u7srzvzS67zetMD+G8VFxcHs9mMffv2obi4GCaTyWp5WVkZdu/eDR8fH/Tu3VtvX7RoEVJSUhAQEIABAwZA0zRs3rwZI0aMwI0bN5CamlqlcZWUlGDIkCHIzMxESEgIevfuDR8fH+Tl5SE9PR1169ZFWlpalbZhxM2bNxEbG4vLly8jLCwMH3zwAcrKypCXl4eMjAyMGDFC73v58mXMmzcP4eHhiIqKQmBgIO7evYstW7Zg8+bNWLp0KSZOnKj3Ly4uRvfu3XHs2DG0bt0aEyZMQEFBATZt2oT4+Hhs2rQJAwYMsBrPqlWrkJ6eDn9/f9SrVw/5+fkOx+5O/Q8//BCZmZlo3rw5Pv30UwBAdnY2UlNT8dtvv2Hv3r2oUaOG3j8rKwv9+vWDyWTC0KFD4eHhgXXr1qFnz57YtGkTEhMTbcYVEhKCpKQkm/ZWrVpVafzdu3dHzZo17R6LrVu34ubNm4iLi3N7PEbnFzA2X0bru7O/RueXDBJyW1JSkgCQnJwcm2V79+4VAJKQkKC33b59W3x9fcXPz0/y8vL09osXL0pAQID4+PjI1atX9faUlBQBIN9//71N/RUrVggAmThxolX79OnTBYDEx8fLkydPrJadPn1asrOz9dfDhg0TALJhwwab+tu2bRMA0q9fPxeOhGO9e/cWAPLNN9/Iy5cvrZbdu3fP6nVBQYHcunXLpsahQ4fEx8dHzGazFBYW6u1Lly4VABIXFyelpaV6+5kzZ8RkMkn9+vWlpKTEqtaRI0fk9OnTUl5eLpmZmQJAhg0bZnfsRusfOHBAAEhERIQUFRXp7SUlJRIVFSUAZPPmzXp7aWmpNG7cWDw8PGTfvn1W++vl5SUNGjSQ4uJiqzF5eXlJdHS03fFWdfyOPHnyRPz8/KRJkyZSUVHh9niMzq+Isflyp749jvbX6PyScTxlVwWW01k5OTk2yyxtlU95bdiwAUVFRejXrx8iIiL09vDwcAwaNAglJSX49ddf3R7P48ePsXjxYphMJqxZswaBgYFWyyMjI9GzZ0+36xv1119/6b8AZsyYAQ8P67fbW2+9ZfU6ICAA9erVs6nTsWNHtGrVCs+fP8fly5f19u3btwMAJk+ebPWttHXr1khKSsKtW7eQm5trVatDhw6IjIyEp6en0/EbrX/t2jUAQOfOna1+MXt7eyMmJgYA8ODBA709NzcXV69eRefOnfXllv2NjY3FzZs37b63XOXO8bFn9erVKCwsRHJyMjRNc3s8RucXMDZf7tS3x9H+Gp1fMo6BVAV9+/aFp6enw0DSNM3qlMuBAwcAAPHx8Tb9LUHx559/uj2erKwsFBUVIS4uDnXr1nW7jisOHjyon2fft2+f3T5//PEHAGDEiBF4+PAhli1bhjlz5uDnn3/G/fv3Xd7WyZMnkZeXB5PJhEaNGuntjx49AgDUr1/fZp2wsDAAwOHDh13ezquM1m/dujU0TcOBAwdQVFSkt5eUlGDv3r0wmUyIjY3V2y1zXfmUroWlzd6xffToEWbPno3k5GRMnToVv//+OyoqKqo8fkfS09Ph5eWF0aNH213u6ngccTS/1cVofUf7a3R+yTheQ6qC0NBQdOnSBfv378f9+/f1b/wFBQU4cuQIoqOj0bBhQ72/5dtZnTp1bGpZAsSVb3COnDhxAgDQtGlTQ+stWLAA69evt2q7e/eu2+OwOHv2rF6rWbNmePz4sb7MbDZj1apVGDx4sM169+7dw+zZs1FeXo5r164hNzcXIoKFCxciICBA7xcSEgIAuH37tk0Ny7fZK1euuD1+o/UjIyORkpKC7777DpGRkejVqxc0TUNOTg4KCwuxfv16NG7cWO9/6dIlAP8Exo8//oiKigpMnjwZDRo0sOpT2fXr1/HVV1/prxcuXIj33nsPmZmZqF27ttvjtyc3Nxdnz57FwIEDHX7JcXU8Fq7Or7uqUv91+2t0fskNb/iU4X+9efPmCQBZu3at3paRkSEA5IsvvrDq27JlSwEge/futalz/PhxASCNGjXS24xeQ0pOTtav17jCcg3pdX+OriEdOXJEgoKCJCgoSA4cOGC3z+DBgwWABAQEyJgxY+TKlSvy+PFjWbFihdSsWVNMJpNcunTJZr0LFy5YjSEoKEgyMzNt+i1ZskQASI8ePayukZw9e1ZMJpMAkKFDhzrcf2fXJNytv3TpUvH19dXH7+3tLdOmTZMHDx5Y9Rs0aJAAkIyMDDl06JDef+fOnZKdnS0ApFevXlbrpKWlyfHjx6WgoEAePHggW7dulcjISP26YXUeH5F/3iNbtmyxu9zIeCxcnd9XOZuvqtYXcb6/Iq7PLxnHQKqic+fOCQAZO3as3jZ58mQBIEePHrXqq2og/Vs3NVg+cKOiomxuaJg2bZoAkLS0NIfrFxcXy6lTp+STTz4RT09Pm+Pw4sULadu2rQCQyMhI+eyzz2TkyJFiNpulW7duAkA++ugjh/WdfcAZrV9RUSFTpkwRHx8fSU9Pl/v378uDBw/kp59+kpo1a0p4eLg8evTI5vhkZGTI/fv3pXnz5tK8eXO5e/euw0Cy586dOxIcHCwA5OTJk9V2fO7evSve3t7SsGFDKS8vdzoOZ+N5lbP5fZWrgeRufWf7a3R+yTheQ6qiFi1aoEWLFlbXkXJyctCgQQO0a9fOqq+/vz8AWJ26srC0VT6l4MoF5Mp9goODAQB37twxsAf/HrPZDADo1auXzQ0NlnPtp06dcri+j48PoqKisHr1asTGxiIlJQWnT5/Wl/v6+iI3NxdTp05FYWEh0tPTsWfPHkyfPh1Tp04FAAQFBbk9fqP1161bhyVLliAlJQUTJkxAaGgoQkJCMG7cOKSmpuLSpUtYvHix3t/yfnj06BFCQ0ORn5+P/Px81K5dGw8fPgQAl05h1alTBz169AAAHDt2rNqOz/Lly1FaWoqxY8e6dFOBs/G8ytn8VpXR+s721+j8knEMpGqQmJiIGzdu4Ny5c7h69SouXLiA/v372wRKkyZNANi/PmNps/QB/v5AAWD3AvHLly+t+gBAdHQ0AODixYtV2Z1qYzmfbu9D1fJhXFxc7LSOpmmIj4/Hy5cvkZ2dbbUsMDAQCxYswOXLl1FaWoqrV68iLS0NFy5cAPD3heiqMFI/KysLwN93Yb3KchfW0aNH9bbw8HAAwK1bt2z637x5E4Dr1wMtd1SWlJS4Pf7KXr58iWXLlsHT0xNjx451aQyujMee181vdXClviv7a3R+yTgGUjWofPu3vdu9LSxv5B07dtgss6zXpUsXvS00NBQA8Pz5c5v+T58+teoDAAkJCfD19cXOnTuV+JXUsWNHALD7MOOrF/SduX79OgDXAqyiogKrVq2CpmlISEhwdbguc1S/oKAAwD93t1Vm+cVT+cuFZa4tdyNWZmmrfDu4IyKi3y3nSoC5cny2bduGa9euISEhwfCdb0bHAxibX3c4q+/K/hqdX3LDmz5n+L+gvLxcQkNDJTExUYYOHSpms9nmgUYRkVu3bjl8MDYwMFB8fHzk2rVrevv+/fsFgLRt21aeP3+ut7948UI6duwoAGT79u1W20hNTXX4YOyZM2eq7cFYV25qePHihbz99tvi7e0tJ06csGpv3769AJCNGzfq7Rs2bLB7zSErK0t8fHwEgNUDpCJ/X8Cu/PBiaWmpfg0vMTHR7rgsXLkmYaT+119/LQDk3XfftXoAs6ioSGJiYgSAfPvtt1a1GjduLJ6enrJ//369/fDhw+Ll5SX169e3eh9lZWXJuXPnrLZZVlYmaWlpAkAaNmxo875z9/j07dtXAMimTZsc9jE6HnfmtzJn81WV+q7sr9H5JeMYSNVk1KhREhAQICEhIZKUlOSw3/z58wWA+Pv7y7Bhw2TEiBESGBgoAGTu3Lk2/S13qjVo0EBGjRolo0ePloYNGwoA6dOnj82T80VFRdKnTx8BIMHBwTJkyBAZNWqUdOzYUTw9PWXOnDl636oEkuWpdTi4ScNi7dq1omma1KxZUz7++GOZPHmyNGvWTL9gX/lmB8t4wsPDpWfPnjJw4EBp06aNvp1JkybZ1B84cKCEhYVJv379ZMCAAVK3bl0BIM2aNbP71P7Bgwdl/PjxMn78eP1/kQgPD9fbli5d6nb9goICadWqlQCQsLAwmTBhgkycOFHCw8MFgLRp00aePXtmtc6WLVvE09NT/Pz8ZMyYMTJ27Fgxm83i4eEhGRkZVn2Tk5NF0zSJiIiQPn36SN++ffX3gp+fn+zatavKx0dE5MqVK+Lh4SF169aVsrIyu33cGY8782tkvtypb2R/3ZlfMoaBVE02btyov/FXrlz52r7r1q2TmJgY8fPzEz8/P+nSpYvVbeOVlZWVyaJFi6Rz584SEhIiwcHB0qlTJ5k/f77VrbyVlZeXy/Lly6Vr164SFBQkJpNJmjZtKhMnTpTz58/r/f4/AklEJDs7W+Lj4/VfgREREfLll1/afJvfs2ePTJkyRaKjo6V27dri7e0tTZo0kd69e8v69evt1l69erV06tRJatWqJSaTSVq2bCmff/65za9DizVr1rz2NveBAwdWqf6TJ09k1qxZ0q5dO/0XZPv27SUtLU2ePn1qd53du3dLXFycmM1mMZvN0r17d9mxY4dNv6ysLBk8eLC888474u/vLzVq1JCwsDAZN26c5OfnV8vxERGZOXOmAJCZM2c67OPOeNyZXyPz5U59I/sr4t78kus0ERF3T/cRERFVF97UQERESmAgERGREhhIRESkBAYSEREpgYFERERKYCAREZESGEhERKQEBhIRESmBgUREREr4P2e4XjAfL+utAAAAAElFTkSuQmCC",
            "value": "VOUCH:6391980597531378"
        }
    }
}

The token value is VOUCH:6391980597531378.

The token value and the barcode can be printed on paper receipts with the amount, or sent via SMS or email. Its up to you to handle the distribution of the code. NB! This value should be kept secret.

Its also possible to create a token that only can be used once by setting the value "card_token.expires_after_transaction": true. You can also limit how long a token can be valid by setting the value "card_token.expires_in": 300 (5 minutes).

Link the Card (Token) to Customer Profile

If you want link the card (token) to a Customer profile , it is possible to add the token by using this endpoint with customer_id: https://docs.dintero.com/api.html#operation/aid_customers_cid_tokens_post

{
   
    "type": "Voucher",
    "value": "VOUCH:6391980597531378",
    "metadata": {
        "order_id": "xk39592f",
        "return_reason": "not happy with the jacket"
    }
}

List the cards on Customer Profile via My Page or in the checkout process

If the customer has multiple tokens (gift cards, vouchers etc), it will be easier to list all Cards by using this endpoint: https://docs.dintero.com/api.html#operation/aid_customers_cid_tokens_get

Using a Virtual Card:

In-Store

1. Customers shows the token via barcode (can be the via paper receipts, email with barcode, SMS etc)
2. Cashier scans the barcode
3. Point of sale creates a https://docs.dintero.com/api.html#operation/aid_cards_transactions_post.

Online / in-App

1. Customers enters the barcode or QR code. It is also possible to link the to a customer profile and show the tokensin the checkout process.
2. eCommerce or your App creates a https://docs.dintero.com/api.html#operation/aid_cards_transactions_post.

Check the balance

The balance can be retrived by this endpoint: https://docs.dintero.com/api.html#operation/aid_cards_token_post