v1

latestOpenAPI 3.0.02026-07-242035712.0 MB

Card V2

Create Bulk Cards

This web service allows to create cards in bulk when given individual details for card and delivery information. Bank will use this api to create bulk cards in advance and print it through manufacturer.

Customer when requires an instant card, bank will create account, customer and link to card.

For linking the card with new customer, use API: /pws/v2/pws_link_card_acc

Version 2 create bulk cards api supports idempotency:

If the previous api request was a success and the client sends the same api_unique_identifier, then the previous response will be returned.
If the previous request fails and the client send the sameapi_unique_identifier, then the new create bulk card request will be processed with the incoming API parameters.

post/pws/v2/pws_create_bulk_cards_with_individual_card_details/

Request body

api_call_unique_identifierstring required

Unique number that must be passed at each API request. Identifier to make each API request unique

card_product_idinteger required

Card product id (Need to input correct product id for your card so it will inherit full required properties and be fully linked with business.)

client_idinteger required

Unique identifier for the client which Paymentology will provide at outset

status_networkinteger required

<p>Status network :</p><ul><li class="docBullet"><code>1000</code>: Fully operational DE39=00</li><li class="docBullet"><code>1001</code>: Refer to issuer DE39=01</li><li class="docBullet"><code>1004</code>: Capture card DE39=04</li><li class="docBullet"><code>1005</code>: Decline all transactions DE39=05</li><li class="docBullet"><code>1008</code>: Honour with ID DE39=08</li><li class="docBullet"><code>1041</code>: Lost card - capture DE39=41</li><li class="docBullet"><code>1043</code>: Stolen card - capture DE39=43</li><li class="docBullet"><code>1054</code>: Expired card - report DE39=54</li><li class="docBullet"><code>1154</code>: Expire card - don't inform</li><li class="docBullet"><code>1062</code>: Restricted card</li><li class="docBullet"><code>1199</code>: Void card - report DE39=05</li></ul>

total_cardsinteger required

Total number of cards to be created

user_idstring

User Id of the Customer who triggered the API request.

remarksstring

Remarks for API request

auth_typestring

<p>Authorization Type - If not provided, default value is taken from product level</p><ul><li class="docBullet"><code>0</code> : Internal</li><li class="docBullet"><code>1</code> : External</li><li class="docBullet"><code>2</code> : Notification</li></ul><p>.</p>

card_manufacturer_idinteger

Card manufacturer id - If not provided in request, default value is taken from product level).

expiry_datestring

<p>Expiry Date, accepted format yyyy-mm-dd hh:mm:ss.<br />If not provided, default expiry from product is inherited.</p>

perso_fieldsstring

<p>Configuration for sensitive data</p><table><tbody><tr><th><strong>Position</strong></th><th><strong>Field</strong></th><th><strong>Description</strong></th></tr><tr><td>1</td><td>RFU</td><td>Reserved for future</td></tr><tr><td>2</td><td>CVV</td><td>set 0 - to send CVV value 000 in card file set 1 - to send actual CVV value in card file </td></tr><tr><td>3</td><td>RFU</td><td>Reserved for future</td></tr><tr><td>4</td><td>RFU</td><td>Reserved for future</td></tr><tr><td>5</td><td>Emboss Name</td><td>0 : Lower case, 1 : Upper case</td></tr></tbody></table><p>Eg : 01001 - Means show CVV and save emboss name as uppercase. If nothing is sent on parameter, default value will be 11111.</p>

tok_flagsstring

<p>Flags for token to assign various tasks to the card. The value 0 means the feature is inactive,while 1 means the feature is Active.</p><p>The values 1 or 0 must be provided on the bit desired position, for example to set a card to decline contact-less transactions, set <strong>position 6</strong> with value 1, as follows: <code>00000010000000000000000000000000</code>.</p><p> Descriptions for each tok flag bits are given below : </p><table><thead><tr><td><strong>TOK_DESCRIPTION</strong></td><td><strong>BIT_POSITION</strong></td></tr></thead><tbody><tr><td title ="After every transaction, send card balance to the scheme, to allow for balance to be displayed, i.e. for ATM transactions">Send card bal in DE54 in next auth</td><td>3</td></tr> <tr><td title ="Should the maximum number of pin retries be exceded, then enable pin unblocking on chip card. Send to issuer to unblock">Send pin unblock to card</td><td>4</td></tr> <tr><td title ="Only allow ecommerce transactions (including MDES and VTS transactions)">Sets card to decline all transactions except for ecommerce</td><td>5</td></tr> <tr><td title ="Set card to decline all Contactless transaction">Set card to decline all Contactless transactions</td><td>6</td></tr> <tr><td title ="Decline all ecommerce transactions (including MDES and VTS transactions)">Sets card to decline all Ecommerce</td><td>9</td></tr> <tr><td title ="Decline all ATM Cash withdrawal transactions">Sets card to decline all ATM</td><td>10</td></tr> <tr><td title ="Do not allow any balance enquiry transactions">Sets card to deline Bal enquiry over auth</td><td>11</td></tr> <tr><td title ="In the case of POS transactions, the cash disbursement of a portion of the transaction amount is not allowed. The merchant cannot give cash to cardholder as part of the transaction.">Sets card to decline cash back txns</td><td>12</td></tr> <tr><td title ="No transactions are allowed that will credit the card balance, including refunds to the card.">Sets card to decline Auth credit pur/refund (DE3_1=20)</td><td>14</td></tr> <tr><td title ="No payments allowed, only POS and ecommerce transactions and. i.e. MC MoneySend, credit card installments, etc">Sets card to decline credit payment (DE3_1=28)</td><td>19</td></tr> <tr><td title ="Only transactions in the base currency are allowed, decline any transaction in a non-base currency">Sets card to decline non base currency txn</td><td>20</td></tr> <tr><td title ="No account verification requests should be allowed">Sets card to decline all account enq (DE61_7=8)</td><td>21</td></tr> <tr><td title ="Only approve transactions where the card is present. If card not present, decline transaction">sets card to decline card not present txns</td><td>22</td></tr> <tr><td title ="card Where the card information is provided but neither the cardholder or the card are physically present (i.e. mail-order) decline the transaction. ">sets card to decline Cardholder not present txns</td><td>23</td></tr> <tr><td title ="CATM Fallback - where a chip-card is used at chip-capable ATM, do not allow fallback to magnetic strip">sets card to decline failover to mag at emv capable atm</td><td>24</td></tr> <tr><td title ="ATM Fallback - where a chip-card is used at an ATM (chip-capable or not) do not allow fallback to magnetic stripe">sets card to decline mag at atm</td><td>25</td></tr> <tr><td title ="POS Fallback - where a chip-card is used at chip-capable POS, allow fallback to to magnetic strip">Alow if fallback chp->mag at chp capable pos DE22_1=80</td><td>26</td></tr> <tr><td title ="POS Fallback - when the magnetic strip is used for a transaction, only allow the transaction of the entire track can be read, i.e. only PAN sent then decline transaction">Allow if DE22_1=02 & DE48_88 =Y</td><td>27</td></tr> <tr><td title ="Sets card to approve if AVS match fails">Sets card to approve if AVS match fails</td><td>28</td></tr> <tr><td title ="Do not allow subscription transactions, decline recurring transactions">Set card to decline Recurring transaction</td><td>29</td></tr> </tbody> </table>

Example request

{
  "api_call_unique_identifier": "438574845790657485",
  "card_product_id": 67,
  "client_id": 760131,
  "individual_card_details": [
    {
      "delivery_details": {
        "address_1": "London",
        "address_2": "Nadipur",
        "city": "Pokhara",
        "country": "Nepal",
        "delivery_method": 1,
        "email": "akshay@paymentology.com",
        "first_name": "Akshay",
        "language": "ENG",
        "mobile_phone_number": "+9779846545555",
        "surname": "Patel",
        "title": "Mr."
      }
    }
  ],
  "status_network": 1000,
  "total_cards": 50,
  "auth_type": "0",
  "card_manufacturer_id": 12,
  "expiry_date": "2025-01-01 00:00:00",
  "perso_fields": "11111",
  "tok_flags": "00000000000000000000000000000000"
}

Response

Successful Response

Example response

{
  "header": {
    "error_desc": "success"
  },
  "body": [
    {
      "expiry": "03/21",
      "token": 788193393,
      "last_four_digit_number": "0082"
    }
  ]
}