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:
- 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).
List the cards on Customer Profile via My Page or in the checkout process
List Customers Virtual Cards by using endpoint: https://docs.dintero.com/api.html#tag/customers/operation/aid_customers_cid_cards_get
Check the balance
https://docs.dintero.com/api.html#tag/customers/operation/aid_customers_cid_card_cid_get
Using a Virtual Card:
In-Store
- Customers shows the token via barcode (can be the via paper receipts, email with barcode, SMS etc) or CardID
- Cashier scans the barcode
- Point of sale creates a https://docs.dintero.com/api.html#operation/aid_cards_transactions_post.
Online / in-App
- Alt A) Logged in Customers can see their own Virtual cards and choose which card to pay with. Alt B): Customers enters their Card ID in the checkout.
- eCommerce or your App creates a https://docs.dintero.com/api.html#operation/aid_cards_transactions_post.