Skip to main content

Version 2.13.22

· 4 min read

Updating the delivery address of a physical card​

We introduced the ability to update the delivery address of a managed card. This feature is particularly useful if the user using a physical card has moved to a different address and you want to make sure that they receive their card at the right address.

You can only update the delivery address for physical cards. If the delivery address is specified when updating a virtual card, the API will return a 409 - Conflict error with error code INSTRUMENT_NOT_PHYSICAL.

New error codes when managing physical cards​

You cannot activate, retrieve or update the pin of a blocked or destroyed physical card. When executing the following APIs on a blocked or destroyed card, the API will return a 409 - Conflict error with error code INSTRUMENT_BLOCKED or INSTRUMENT_DESTROYED:

  • POST /managed_cards/\{id\}/physical/activate/
  • POST /managed_cards/\{id\}/physical/pin/unblock
  • POST /managed_cards/\{id\}/physical/pin/get
  • POST /managed_cards/\{id\}/physical/pin/set

New error code when updating the details of a consumer​

A new error code EMAIL_NOT_UNIQUE has been added to the POST /consumers/\{id\}/update API. This error code will be returned if the new email address being specified is already being used by another consumer in your community.

API ChangeLog​

What's Changed​

POST /corporates/{id}/kyb/start​
Return Type:​

Changed response : 409 Conflict

Conflict

  • Changed content type : application/json

    • Changed property errorCode (string)

      Added enum value:

      • KYB_REJECTED
POST /consumers/{id}/update​
Return Type:​

Changed response : 409 Conflict

Conflict

  • Changed content type : application/json

    • Changed property errorCode (string)

      Added enum value:

      • EMAIL_NOT_UNIQUE
POST /consumers/{id}/kyc/start​
Return Type:​

Changed response : 409 Conflict

Conflict

  • Changed content type : application/json

    • Changed property errorCode (string)

      Added enum value:

      • KYC_REJECTED
POST /managed_cards/{id}/update​
Request:​

Changed content type : application/json

  • Added property deliveryAddress (object)

    • Property addressLine1 (string)

      Address of the identity

    • Property addressLine2 (string)

      Continued address of the identity

    • Property city (string)

      City of the identity

    • Property country (string)

      Country of the identity - using ISO 3166 alpha-2

    • Property postCode (string)

      Post code of the identity

    • Property state (string)

      State of the identity

    • Property name (string)

      The first name of the addressee

    • Property surname (string)

      The last name of the addressee

Return Type:​

Changed response : 409 Conflict

Conflict

  • Changed content type : application/json

    • Changed property errorCode (string)

      Added enum value:

      • INSTRUMENT_NOT_PHYSICAL
POST /managed_cards/{id}/physical/replace_lost_stolen​
Return Type:​

Changed response : 409 Conflict

Conflict

  • Changed content type : application/json

    • Changed property errorCode (string)

      Removed enum value:

      • PHYSICAL_CARD_NOT_ACTIVATED
POST /managed_cards/{id}/physical/report_lost​
Return Type:​

Changed response : 409 Conflict

Conflict

  • Changed content type : application/json

    • Changed property errorCode (string)

      Removed enum value:

      • PHYSICAL_CARD_NOT_ACTIVATED
POST /managed_cards/{id}/physical/activate​
Return Type:​

Changed response : 409 Conflict

Conflict

  • Changed content type : application/json

    • Changed property errorCode (string)

      Added enum values:

      • INSTRUMENT_BLOCKED
      • INSTRUMENT_DESTROYED
POST /managed_cards/{id}/physical/upgrade​
Request:​

Changed content type : application/json

  • Changed property deliveryMethod (string)

    The preferred method of delivery for this physical card. If unspecified, standard delivery would be the default delivery method.

    Added enum value:

    • FIRST_CLASS_MAIL
POST /managed_cards/{id}/physical/pin/get​
Return Type:​

Changed response : 409 Conflict

Conflict

  • Changed content type : application/json

    • Changed property errorCode (string)

      Added enum values:

      • INSTRUMENT_BLOCKED
      • INSTRUMENT_DESTROYED
POST /managed_cards/{id}/physical/pin/set​
Return Type:​

Changed response : 409 Conflict

Conflict

  • Changed content type : application/json

    • Changed property errorCode (string)

      Added enum values:

      • INSTRUMENT_BLOCKED
      • INSTRUMENT_DESTROYED
POST /managed_cards/{id}/physical/pin/unblock​
Return Type:​

Changed response : 409 Conflict

Conflict

  • Changed content type : application/json

    • Changed property errorCode (string)

      Added enum values:

      • INSTRUMENT_BLOCKED
      • INSTRUMENT_DESTROYED
POST /transfers/_/execute​
Return Type:​

Changed response : 200 OK

Success

  • Changed content type : application/json

    • Changed property conflict (string)

      Added enum value:

      • TRANSFER_BETWEEN_INSTRUMENTS_UNSUPPORTED Removed enum value:

      • CROSS_PROVIDER_TRANSFER_UNSUPPORTED Changed response : 409 Conflict

Conflict

  • Changed content type : application/json

    • Changed property errorCode (string)

      Added enum value:

      • TRANSFER_BETWEEN_INSTRUMENTS_UNSUPPORTED Removed enum value:

      • CROSS_PROVIDER_TRANSFER_UNSUPPORTED

POST /send/_/execute​
Return Type:​

Changed response : 200 OK

Success

  • Changed content type : application/json

    • Changed property conflict (string)

      Added enum values:

      • SEND_TO_INSTRUMENT_UNSUPPORTED

      • SOURCE_INSTRUMENT_BLOCKED

      • DESTINATION_INSTRUMENT_BLOCKED Removed enum values:

      • ACCOUNT_BLOCKED

      • CROSS_PROVIDER_SEND_UNSUPPORTED Changed response : 409 Conflict

Conflict

  • Changed content type : application/json

    • Changed property errorCode (string)

      Added enum values:

      • SEND_TO_INSTRUMENT_UNSUPPORTED

      • SOURCE_INSTRUMENT_BLOCKED

      • DESTINATION_INSTRUMENT_BLOCKED Removed enum values:

      • ACCOUNT_BLOCKED

      • CROSS_PROVIDER_SEND_UNSUPPORTED