Create User Card | Kard API

curl -X POST https://rewards-api.getkard.com/users/users/%7Bid%7D/cards \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "referringPartnerUserId": "1234567890",
  "cards": [
    {
      "last4": "1234",
      "bin": "123456",
      "issuer": "Name_Of_Issuer",
      "network": "VISA",
      "status": "ENABLED"
    }
  ]
}'

{
  "_id": "5e135a5a2b1f4c0008c9df79",
  "referringPartner": "Name_Of_Issuer",
  "referringPartnerUserId": "1234567890",
  "cards": [
    {
      "_id": "5e135a5a2b1f4c0008c9df80",
      "last4": "1234",
      "bin": "123456",
      "issuer": "Name_Of_Issuer",
      "network": "VISA",
      "status": "ENABLED"
    }
  ],
  "createdDate": "2020-10-27T17:34:49.964Z",
  "lastModified": "2020-10-27T17:34:49.964Z",
  "__v": 0,
  "email": "someone@email.com",
  "hashedEmail": "a1b2c3d4e5f6789012345678901234567890abcdef1234567890abcdef123456",
  "phoneNumber": "+12345678901",
  "birthYear": "1990",
  "userName": "some_user_name",
  "firstName": "John",
  "lastName": "Doe",
  "zipCode": "10028",
  "externalPartnerUserId": "67890123",
  "enrolledRewards": [
    "CARDLINKED"
  ]
}

Call this endpoint to create a card that a specified user enrolled in rewards will use to make purchases and earn rewards.
Required scopes: user:write

curl -X POST https://rewards-api.getkard.com/users/users/%7Bid%7D/cards \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "referringPartnerUserId": "1234567890",
  "cards": [
    {
      "last4": "1234",
      "bin": "123456",
      "issuer": "Name_Of_Issuer",
      "network": "VISA",
      "status": "ENABLED"
    }
  ]
}'

{
  "_id": "5e135a5a2b1f4c0008c9df79",
  "referringPartner": "Name_Of_Issuer",
  "referringPartnerUserId": "1234567890",
  "cards": [
    {
      "_id": "5e135a5a2b1f4c0008c9df80",
      "last4": "1234",
      "bin": "123456",
      "issuer": "Name_Of_Issuer",
      "network": "VISA",
      "status": "ENABLED"
    }
  ],
  "createdDate": "2020-10-27T17:34:49.964Z",
  "lastModified": "2020-10-27T17:34:49.964Z",
  "__v": 0,
  "email": "someone@email.com",
  "hashedEmail": "a1b2c3d4e5f6789012345678901234567890abcdef1234567890abcdef123456",
  "phoneNumber": "+12345678901",
  "birthYear": "1990",
  "userName": "some_user_name",
  "firstName": "John",
  "lastName": "Doe",
  "zipCode": "10028",
  "externalPartnerUserId": "67890123",
  "enrolledRewards": [
    "CARDLINKED"
  ]
}

Call this endpoint to create a card that a specified user enrolled in rewards will use to make purchases and earn rewards.
Required scopes: user:write

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

idstringRequired

Referring partner user ID from issuer that specifies user

Request

This endpoint expects an object.

referringPartnerUserIdstringRequired

Referring partner user ID from issuer

cardslist of objectsOptional

List of User Cards Information to add

cardInfoobjectOptionalDeprecated

[Deprecated — please use “cards” field] User Card Information

Response

This endpoint returns an object.

_idstring

Unique user ID of user in Kard's system

referringPartnerstring

Issuer name

referringPartnerUserIdstring

Referring partner user ID of user from issuer

cardslist of objects

List of User Cards Information (this will include the newly added cards added).

createdDatedatetime

Created date of user in Kard’s system (UTC)

lastModifieddatetime

Last modified date of user in Kard’s system (UTC)

__vinteger

Version of user in Kard's system

emailstring

Email of user if available

hashedEmailstring

Hashed email address of user (using SHA-256)

phoneNumberstring

Phone number of user in E.164 format

birthYearstring

Birth year of user

userNamestring

Username of user if available

firstNamestring

First name of user if available

lastNamestring

Last name of user if available

zipCodestring

Zipcode of user if available

externalPartnerUserIdstring

Partner unique user id, might be equal to referringPartnerUserId, if available

enrolledRewardslist of enums

List of enrolled rewards

Allowed values:

Errors

400

Invalid Request

401

Unauthorized Error

404

Does Not Exist Error

409

Conflict Error

500

Internal Server Error

$	curl -X POST https://rewards-api.getkard.com/users/users/%7Bid%7D/cards \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"referringPartnerUserId": "1234567890",
>	"cards": [
>	{
>	"last4": "1234",
>	"bin": "123456",
>	"issuer": "Name_Of_Issuer",
>	"network": "VISA",
>	"status": "ENABLED"
>	}
>	]
>	}'

1	{
2	"_id": "5e135a5a2b1f4c0008c9df79",
3	"referringPartner": "Name_Of_Issuer",
4	"referringPartnerUserId": "1234567890",
5	"cards": [
6	{
7	"_id": "5e135a5a2b1f4c0008c9df80",
8	"last4": "1234",
9	"bin": "123456",
10	"issuer": "Name_Of_Issuer",
11	"network": "VISA",
12	"status": "ENABLED"
13	}
14	],
15	"createdDate": "2020-10-27T17:34:49.964Z",
16	"lastModified": "2020-10-27T17:34:49.964Z",
17	"__v": 0,
18	"email": "someone@email.com",
19	"hashedEmail": "a1b2c3d4e5f6789012345678901234567890abcdef1234567890abcdef123456",
20	"phoneNumber": "+12345678901",
21	"birthYear": "1990",
22	"userName": "some_user_name",
23	"firstName": "John",
24	"lastName": "Doe",
25	"zipCode": "10028",
26	"externalPartnerUserId": "67890123",
27	"enrolledRewards": [
28	"CARDLINKED"
29	]
30	}