Manage payment cards on a payer account.

/cnbs/v1/customers/id/payer/payment_cards

POST

• Payer Data (payer_data)
  • Customer Number (customer_number)
• Action (action)
  • 01 … Insert new payment card.
  • 02 … Modify existing payment card.
  • 03 … Delete existing payment card.
  • 04 … Preauthorization call only
• Payment Card Table (payment_cards)
  • Payment card: Card Type (payment_card_type)
    • Payment card type used for this transaction.
  • Payment Card Token (payment_card_token)
    • Tokenized form of payment card.

To insert or modify a payment card record.

• Payment Card Table (payment_cards)
  • Payment Card Name (payment_card_name)
    • Name of the card holder.
  • Payment card: Valid-To Date (valid_to)
    • Expiry date of the payment card.
      • Will be set internally for E-Check card type (EC).
  • Payment card: Default Flag (default)
    • Payment card default flag in backend customer master data.

To Insert a new E-Check

• Payment Card Table (payment_cards)
  • Electronic Check Account Type (electronic_check_account_type)
    • C … Consumer Checking Account (U.S. and Canada)
    • S … Consumer Savings Account (U.S. only)
    • X … Corporate Checking Account (U.S. only)
  • Electronic Check Routing Number (electronic_check_rdfi_number)
    • Receiving Depository Financial Institution Number.

To insert a new payment card

• Company Code (company_code)
  • If pre-authorization is turned on in the CNBS API customizing for the payment card, then the company code is required.
• Payment Card Table (payment_cards)
  • Payment card: Card Validation Code (card_validation_code)
    • The CVV or card validation code is also known as CSC (“Card Security Code”), as well as CVV2. They are all the same as a card validation code, except that they have been generated by a 2nd generation process.

JSON Payload:

{
  "payer_data": {
    "customer_number": "3050",
    "company_code": ""
  },
  "action": "02",
  "payment_cards": [
    {
      "payment_card_type": "AMEX",
      "payment_card_token": "-E803-5144-CQ5FR2X61TWP41",
      "payment_card_name": "John Doe",
      "valid_from": "",
      "valid_to": "05-31-2027",
      "default": "X",
      "electronic_check_account_type": "",
      "electronic_check_rdfi_number": "",
      "card_validation_code": ""
    }
  ]
}

cURL

curl -X POST "https://<<your.server.here>>/cnbs/v1/customers/id/payer/payment_cards?sap-client=800&sap-language=EN&apiid=CNBSMV01P" -H  "accept: application/json" -H  "content-type: application/json" -H  "cnbssysid: gPuM1VyY1dxlTE2MEs2yajJUkX3/4+2Pw1alRw4BOtI=" -d "{  \"payer_data\": {    \"customer_number\": \"3050\",    \"company_code\": \"\"  },  \"action\": \"02\",  \"payment_cards\": [    {      \"payment_card_type\": \"AMEX\",      \"payment_card_token\": \"-E803-5144-CQ5FR2X61TWP41\",      \"payment_card_name\": \"John Doe\",      \"valid_from\": \"\",      \"valid_to\": \"05-31-2027\",      \"default\": \"X\",      \"electronic_check_account_type\": \"\",      \"electronic_check_rdfi_number\": \"\",      \"card_validation_code\": \"\"    }  ]}"

• Status (status)
  • Message Type (message_type)
    • SAP Message Type.
      • Errors:
        • E = Error
        • A = Abort
        • X = Exception
      • Others:
        • S = Success
        • W = Warning
        • I = Information
  • Message Identifier (message_identification)
    • SAP Message ID.
  • Message Number (message_number)
    • SAP Message Number.
  • Message Line (message_line_string)
    • SAP Message Text.

JSON:

{
  "message_type": "S",
  "message_identification": "/CNBS/X_API",
  "message_number": 10,
  "message_line_string": "Request successfully processed"
}