{"metadata":{"image":[],"title":"","description":""},"api":{"url":"","auth":"required","results":{"codes":[]},"settings":"","params":[]},"next":{"description":"","pages":[]},"title":"credit-card (resource)","type":"basic","slug":"credit-card-resource","excerpt":"","body":"The `credit-card` resource contains the details for a specific credit card, such as the card number and expiration date. It includes the following properties:\n\n###Request\n[block:parameters]\n{\n  \"data\": {\n    \"h-0\": \"Property Name\",\n    \"h-1\": \"Type\",\n    \"h-2\": \"Required\",\n    \"0-0\": \"`card-number`\",\n    \"0-1\": \"*string*\",\n    \"h-3\": \"Description\",\n    \"0-3\": \"Credit card number.\\nFor example:\\n  * 4111111111111111\\n  * 4111-1111-1111-1111\\n  * 4111 1111 1111 1111\",\n    \"1-0\": \"`encrypted-card-number`\",\n    \"1-1\": \"*string*\",\n    \"1-3\": \"Encrypted credit card number.\",\n    \"h-4\": \"Description\",\n    \"0-2\": \"**Required**, if `encrypted-card-number` is not sent.\",\n    \"1-2\": \"**Required**, if `card-number` is not sent.\",\n    \"2-0\": \"`card-last-four-digits`\",\n    \"2-1\": \"*string*\",\n    \"2-3\": \"Last four digits of the credit card.\",\n    \"2-2\": \"Optional\",\n    \"3-0\": \"`card-type`\",\n    \"4-0\": \"`expiration-month`\",\n    \"5-0\": \"`expiration-year`\",\n    \"6-0\": \"`security-code`\",\n    \"7-0\": \"`encrypted-security-code`\",\n    \"3-1\": \"*string*\",\n    \"6-1\": \"*string*\",\n    \"7-1\": \"*string*\",\n    \"4-1\": \"*integer*\",\n    \"5-1\": \"*integer*\",\n    \"3-2\": \"Optional, if sending `card-number` or `encrypted-card-number`.\\n\\n**Note**: If you do not send the `card-type`, BlueSnap will automatically identify the type based on the number. If you do send a card type but BlueSnap identifies that the card is a different type, the transaction will fail. You can check the card type for a specific number using the [Retrieve Card Info](/v8976-Tools/docs/retrieve-card-info) request.\",\n    \"4-2\": \"**Required**\",\n    \"5-2\": \"**Required**\",\n    \"6-2\": \"Optional, but strongly recommended for first-time charges.\",\n    \"7-2\": \"Optional, but strongly recommended for first-time charges.\",\n    \"3-3\": \"Credit card type.\",\n    \"4-3\": \"Credit card expiration month.\",\n    \"5-3\": \"Credit card expiration year.\",\n    \"6-3\": \"Credit card security code.\",\n    \"7-3\": \"Encrypted credit card security code.\"\n  },\n  \"cols\": 4,\n  \"rows\": 8\n}\n[/block]\n###Response\n[block:parameters]\n{\n  \"data\": {\n    \"h-0\": \"Property Name\",\n    \"h-1\": \"Type\",\n    \"h-2\": \"Description\",\n    \"0-0\": \"`card-last-four-digits`\",\n    \"0-1\": \"*string*\",\n    \"h-3\": \"Description\",\n    \"0-3\": \"Defines the type of transaction. Values can be:\\nAUTH_ONLY\\nAUTH_CAPTURE\\nCAPTURE\\nAUTH_REVERSAL\\nSee Transaction Types\",\n    \"1-0\": \"`card-type`\",\n    \"1-1\": \"*string*\",\n    \"1-3\": \"BlueSnap identifier for the transaction.\",\n    \"h-4\": \"Description\",\n    \"0-2\": \"Last four digits of the credit card.\",\n    \"1-2\": \"Credit card type.\",\n    \"5-0\": \"`issue-number`\",\n    \"5-1\": \"*string*\",\n    \"5-2\": \"Issue number on the credit card.\",\n    \"2-0\": \"`card-sub-type`\",\n    \"2-1\": \"*string*\",\n    \"3-1\": \"*integer*\",\n    \"4-1\": \"*integer*\",\n    \"4-2\": \"Credit card expiration year.\",\n    \"4-0\": \"`expiration-year`\",\n    \"3-2\": \"Credit card expiration month.\",\n    \"3-0\": \"`expiration-month`\",\n    \"2-2\": \"Card sub-type, such as Credit or Debit.\"\n  },\n  \"cols\": 3,\n  \"rows\": 6\n}\n[/block]","updates":[],"order":6,"isReference":true,"hidden":false,"sync_unique":"","link_url":"","link_external":false,"_id":"603fec227146110018e1da79","category":{"sync":{"isSync":false,"url":""},"pages":[],"title":"Account Updater","slug":"account-updater","order":4,"from_sync":false,"reference":true,"_id":"603fec227146110018e1da41","version":"603fec227146110018e1daaf","project":"57336fd5a6a9c40e00e13a0b","createdAt":"2016-05-17T12:18:23.126Z","__v":0},"user":"560d5913af97231900938124","project":"57336fd5a6a9c40e00e13a0b","parentDoc":null,"version":{"version":"8976-Tools","version_clean":"8976.0.0-Tools","codename":"3.37 Release","is_stable":false,"is_beta":false,"is_hidden":false,"is_deprecated":false,"categories":["603fec227146110018e1da3d","603fec227146110018e1da3e","603fec227146110018e1da3f","603fec227146110018e1da40","603fec227146110018e1da41","603fec227146110018e1da42","603fec227146110018e1da43","603fec227146110018e1da44","603fec227146110018e1da45","603fec227146110018e1da46","603fec227146110018e1da47","603fec227146110018e1da48","5b34c737e0dca2000311de6a","603fec227146110018e1da49","603fec227146110018e1da4a","603fec227146110018e1da4b","603fec227146110018e1da4c","603fec227146110018e1da4d","603fec227146110018e1da4e","603fec227146110018e1da4f"],"_id":"603fec227146110018e1daaf","project":"57336fd5a6a9c40e00e13a0b","__v":0,"forked_from":"6019bc72944282005e966fd4","createdAt":"2018-04-23T15:17:35.680Z","releaseDate":"2018-04-23T15:17:35.680Z"},"createdAt":"2016-07-25T19:17:23.461Z","githubsync":"","__v":0}

credit-card (resource)


The credit-card resource contains the details for a specific credit card, such as the card number and expiration date. It includes the following properties:

Request

Property Name
Type
Required
Description

card-number

string

Required, if encrypted-card-number is not sent.

Credit card number.
For example:

  • 4111111111111111
  • 4111-1111-1111-1111
  • 4111 1111 1111 1111

encrypted-card-number

string

Required, if card-number is not sent.

Encrypted credit card number.

card-last-four-digits

string

Optional

Last four digits of the credit card.

card-type

string

Optional, if sending card-number or encrypted-card-number.

Note: If you do not send the card-type, BlueSnap will automatically identify the type based on the number. If you do send a card type but BlueSnap identifies that the card is a different type, the transaction will fail. You can check the card type for a specific number using the Retrieve Card Info request.

Credit card type.

expiration-month

integer

Required

Credit card expiration month.

expiration-year

integer

Required

Credit card expiration year.

security-code

string

Optional, but strongly recommended for first-time charges.

Credit card security code.

encrypted-security-code

string

Optional, but strongly recommended for first-time charges.

Encrypted credit card security code.

Response

Property Name
Type
Description

card-last-four-digits

string

Last four digits of the credit card.

card-type

string

Credit card type.

card-sub-type

string

Card sub-type, such as Credit or Debit.

expiration-month

integer

Credit card expiration month.

expiration-year

integer

Credit card expiration year.

issue-number

string

Issue number on the credit card.