Create Card

Overview

This route will allow users to create cards for buyers. The user can create Lodged / Exact Match cards, Lodged P-Cards and add external cards in CPX.

Resource Access

POST https://<hostname>/buyer/v1/buyer/<buyerID>/createCard

Arguments

The requested criteria can be a combination of one or more of the following fields:

Field	Sub-field	Additional Information
type		Mandatory
cardHolderName		Optional
cardRuleId		Optional
cardNumber		Optional
securityCode		Optional
expirationString		Optional
address		Optional
	street1	Optional
	city	Optional
	state	Optional
	postalCode	Optional
	country	Optional
isDefault		Optional
creditLimit		Optional
dailySpendLimit		Optional
sid		Optional

Example Request


{
   "type": "ExternalCard",
   "cardHolderName": "John doe new 3",
   "cardNumber": "2221000000000009",
   "securityCode": "1112",
   "expirationString": "02/2021",
   "address": {
       "street1": "Address 1234",
       "city": "Los angeles",
       "state": "CA",
       "postalCode": "12345",
       "country": "USA"
   }
}


{
    "sid": "CPX2743Supplier3",
    "type": "Lodged / P-Card",
    "cardRuleId": "6c862809-37b8-5c57-9ca6-129bf35c898911",
    "creditLimit": 4,
    "dailySpendLimit": 4
 
}


{
    "type": "Lodged / Exact Match",
    "sid": "Supplier 100"
}

Example Response



{
   "card": {
       "id": "844f0b1e10b5369626387be2eb7d4325048c2c382006ea63b1668b8162b0f1b0",
       "address": {
           "street1": "Address 1234",
           "city": "Los angeles",
           "state": "CA",
           "postalCode": "12345",
           "country": "USA"
       },
       "cardHolderName": "John doe new 3",
       "expirationString": "02/2025",
       "last4": "****0009",
       "isDefault": true
   }
}



{
   "card": {
       "id": "c8de6b78fa12ec70995f301fe6a772d329e33eaa17bee230cf",
       "cardEntityId": "78f151fffa12ec70995f301fe6a772d329e33eaa17bee230cf",
       "creditLimit": "400.00",
       "supplier": {
           "id": "7063c0d1-f302-5533-88f2-feb5e2d7b09f"
       },
       "template": {
           "id": "d0ebf5f0-6c6f-5c38-8c3e-be80d30a4fcf",
           "host": "braves",
           "name": "Lodged / P-Card",
           "type": "Lodged / P-Card",
           "ruleType": "Lodged",
           "billLevel": "buyer",
           "isDefault": false,
           "ruleValue": "0598736999944155",
           "isExactAmount": false,
           "expirationDays": "1250"
       },
       "createdNotificationSent": "2024-08-23T10:04:01.740Z",
       "dailySpendLimit": "4.00",
       "reference": "2024082306035900061182",
       "expirationString": "0128"
   },
   "message": "Lodged / P-Card created and sent to the supplier."
}


{
   "card": {
       "id": "8443ccc7-8451-50c7-bed3-73ea8d0904fd",
       "supplier": {
           "id": "bb221f9d-343c-5b53-8099-d0a7c93ad042",
           "sid": "45544",
           "name": " rw-test-supplier-1"
       },
       "address": {
           "city": "RUSSELLVILLE",
           "state": "AL",
           "country": "USA",
           "street1": "15046 HWY 43 STE C RUSSELLVILLE",
           "street2": "FRANKLIN",
           "postalCode": "35653"
       },
       "expirationString": "2029-08-22",
       "network": {
           "id": "b5027e31-b9d6-577c-b600-69c03c1f7c90",
           "name": "QA Network",
           "nid": "qaNid"
       },
       "institution": {
           "id": "89225943-b350-53c9-8a48-500d427c2e1c",
           "name": "REGRESSION",
           "fid": "53324",
           "vcnHost": "braves",
           "corpId": "NA"
       },
       "buyer": {
           "id": "01a20c12-8e54-5ffb-b789-1ae3a062d294",
           "name": "Exact Match Lodge Card",
           "bid": "234568",
           "vcnHost": "braves"
       },
       "vcnReference": "2024082306063900061184",
       "vcnStatus": "Pending"
   }
}