WOworldline
card

POST /updateCardCredentials

Update a card with its credentials. In case of error, no retry will be triggered on client side.

Request

Headers

Authorizationstring

OAuth2 Authorization.

Request body

signaturestring

Base64 URL encoded value representation of the signature output. The payload used to generate the signature consists of the JSON serialization of the whole object, excluding old signatures and null values, which is then Base 64 URL encoded as well

Example request

{
  "header": {
    "requestId": "d6156f8a-a504-48c4-8f5a-722606bd3d91",
    "service": "ACS_H0A",
    "issuerCode": "66666",
    "subIssuerCode": "66666",
    "keyTag": "01",
    "iv": "d6156f8aa50448c48f5a722606bd3d91"
  },
  "body": {
    "cardHolderId": "2b7bdce2-b647-43e8-9e32-049605531c4a",
    "dynamicLinking": {
      "xid": "1234567890",
      "binAcquirer": "700004",
      "browserIP": "155.155.155.155",
      "cardType": "CREDIT",
      "convertedAmount": {
        "amount": "2000",
        "exponent": "2",
        "currency": {
          "code": "978",
          "label": "EUR"
        }
      },
      "transactionAmount": {
        "amount": "2000",
        "exponent": "2",
        "currency": {
          "code": "978",
          "label": "EUR"
        }
      },
      "deviceChannel": "02",
      "deviceOs": "Android",
      "amountInd": "01",
      "frequencyInd": "01",
      "maskedPan": "497670xxxxxxxx14",
      "maskedVPan": "817080xxxxxxxx16",
      "merchant": {
        "id": "123456789",
        "name": "MY SHOPPING",
        "url": "www.myshopping.com",
        "country": "250"
      },
      "messageCategory": "01",
      "network": "MASTERCARD",
      "purchaseDate": "20191223141802",
      "purchaseInstalData": "2",
      "recurringDate": "20241223",
      "recurringExpiry": "20251223",
      "recurringFrequency": "31",
      "recurringAmount": {
        "amount": "2000",
        "exponent": "2",
        "currency": {
          "code": "978",
          "label": "EUR"
        }
      },
      "threeDSRequestorAuthenticationInd": "01",
      "threeDSRequestorDecMaxTime": "180",
      "threeDSRequestorDecReqInd": "Y",
      "threeRIInd": "01",
      "transactionDate": "2023-09-23T14:18:02",
      "ua": "Mozilla/5.0 (Windows NT 6.1; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/71.0.3578.98 Safari/537.36"
    },
    "principal": {
      "type": "pan",
      "value": "4976700000000114"
    },
    "expiry": {
      "type": "plain",
      "value": "2020-01"
    },
    "credentials": {
      "type": "plain",
      "value": "{\"METHOD:PWD\":[{\"value\":\"f2d81a260dea8a100dd517984e53c56a7523d96942a834b9cdc249bd4e8c7aa9\",\"algorithm\":\"SHA-256\"}]}"
    }
  },
  "footer": {}
}

Response

OK.

signaturestring

Base64 URL encoded value representation of the signature output. The payload used to generate the signature consists of the JSON serialization of the whole object, excluding old signatures and null values, which is then Base 64 URL encoded as well

Example response

{
  "header": {
    "requestId": "d6156f8a-a504-48c4-8f5a-722606bd3d91",
    "service": "ACS_H0A",
    "issuerCode": "66666",
    "subIssuerCode": "66666",
    "keyTag": "01",
    "iv": "d6156f8aa50448c48f5a722606bd3d91"
  },
  "body": {
    "availableMeans": [
      "TA",
      "EXTOTP"
    ],
    "cardId": "58ba0332-69d3-4c48-a954-f91071dffe29",
    "cardholderId": "7e946be6-8ba9-4102-9e4f-8068b493e325",
    "credentials": {
      "type": "plain",
      "value": "{\"METHOD:PWD\":[{\"value\":\"f2d81a260dea8a100dd517984e53c56a7523d96942a834b9cdc249bd4e8c7aa9\",\"algorithm\":\"SHA-256\"}]}"
    },
    "deletedTime": "2016-11-16 06:43:19.77",
    "label": "STD BANK SMS",
    "language": "en"
  },
  "footer": {}
}

Changes

No recorded changes to this operation across all 1 revision of this API.