Assign Card

Assign an instant issue or anonymous card to a Person.

Request
Security:
path Parameters
version
required
string
Request Body schema: application/json
required
object (PersonDTO)
required
object (CardDTO)

The card resource represents a plastic or virtual card issued by Qolo. Important attributes of card are

  1. Card number - Primary Account Number (PAN) uniquely identifies you card
  2. CVV2
  3. Expiration Date
  4. CH Name
Responses
200

Returns the newly assigned Card

400

Bad request

401

Unauthorized

404

Card not found

500

Server Error

post/api/{version}/cards/assign
Request samples
application/json
{
  • "person": {
    • "identifications": [
      • {
        • "govt_id_type": "NOTPROVIDED",
        • "govt_id_number": "string"
        }
      ],
    • "person_guid": "2ae6ba4b-f6c0-4817-a158-43e5a87168fd",
    • "birth_date": "string",
    • "email": "string",
    • "first_name": "string",
    • "middle_name": "string",
    • "last_name": "string",
    • "additional_data": {
      • "property1": "string",
      • "property2": "string"
      },
    • "mobile_number": "string",
    • "home_number": "string",
    • "office_number": "string",
    • "base_address": {
      • "city": "string",
      • "country": "str",
      • "address_line1": "string",
      • "address_line2": "string",
      • "postal_code": "string",
      • "state": "string"
      },
    • "mailing_address": {
      • "city": "string",
      • "country": "str",
      • "address_line1": "string",
      • "address_line2": "string",
      • "postal_code": "string",
      • "state": "string"
      },
    • "billing_address": {
      • "city": "string",
      • "country": "str",
      • "address_line1": "string",
      • "address_line2": "string",
      • "postal_code": "string",
      • "state": "string"
      },
    • "nationality": "str",
    • "ip_address": "string",
    • "person_status": "INCOMPLETE",
    • "client_reference_id": "string",
    • "verfication_mode": "string",
    • "verfication_level": "string",
    • "person_forget_mode": "string",
    • "person_forget_mode_date": "string",
    • "market_notification_optin": "string",
    • "market_notification_optin_date": "string",
    • "address_lat": 0,
    • "address_lon": 0,
    • "contact_type": "string",
    • "profile_dd_mode": "string",
    • "request_code": "string",
    • "wallet_id": "string",
    • "title": "string",
    • "mask_govt_id_number": "string",
    • "comments": "string",
    • "jurisdiction_state": "string",
    • "jurisdiction_country": "str",
    • "beneficial_ownership": 100,
    • "person_relations": [
      • {
        • "holder_person_guid": "67b4ee47-03be-4fa4-8a21-68a2b2312803",
        • "related_person_guid": "ad395ead-8b71-46c4-b7c0-1c41ae432595",
        • "person_relationship": "string",
        • "sys_utcinserted": "2019-08-24T14:15:22Z",
        • "sys_utcupdated": "2019-08-24T14:15:22Z"
        }
      ],
    • "mask_account_number": "string",
    • "ledger_balance": 0,
    • "program_guid": "3fa0d2ea-ffcf-485d-94ed-dbf4f861ad2f"
    },
  • "card": {
    • "card_number": "string",
    • "card_proxy": "string",
    • "mask_card_pan": "string",
    • "wallet_guid": "17eaeda9-c0ab-4ac3-8ef9-27ac9b388a03",
    • "wallet_id": "string",
    • "issuance_type": "FULL",
    • "base_iin": "string",
    • "card_condition": "ORIGINAL",
    • "card_status": "ACTIVE",
    • "activation_date": "2019-08-24T14:15:22Z",
    • "activation_method": "ONLOAD",
    • "expiration_date": "string",
    • "cvx2": "string",
    • "logical_expiration_date": "2019-08-24T14:15:22Z",
    • "person_card_status": "ACTIVE",
    • "card_tracking_detail": {
      • "fulfillment_house_name": "string",
      • "card_requested": "2019-08-24T14:15:22Z",
      • "card_shipment_date": "2019-08-24T14:15:22Z",
      • "card_delivery_method": "string",
      • "card_delivery_tracking_number": "string",
      • "card_package_name": "string",
      • "card_order_status": "string",
      • "digital_package_name": "string",
      • "digital_package_id": "string"
      },
    • "status_change_nonmon_detail": {
      • "nonmon_guid": "3df16cd2-de7f-4e81-936e-7604855d1fd7",
      • "txn_date": "2019-08-24T14:15:22Z",
      • "channel_name": "string",
      • "request_code": "string",
      • "reason_code": "string",
      • "response_code": "string",
      • "person_guid": "2ae6ba4b-f6c0-4817-a158-43e5a87168fd",
      • "hash_account_number": "string",
      • "remarks": "string",
      • "account_guid": "d2b7c9d2-85e7-4c51-92d0-3f97a47f8d76",
      • "journal_guid": "019b8be6-224f-4e54-91ec-2a471754d334",
      • "support_user_guid": "334ad5b0-1427-4c28-aac8-2d6e9614b4d0",
      • "source_code": "string",
      • "source_user_guid": "0aaedba8-146e-40a6-ad5f-54c512699647",
      • "reference_number": "string",
      • "outsort_guid": "eef602a5-424d-4eae-b4d8-4521969d8873",
      • "order_guid": "dd878538-67b6-4e7d-8e8a-ddc3e971d02f",
      • "processing_start_date": "2019-08-24T14:15:22Z",
      • "processing_end_date": "2019-08-24T14:15:22Z"
      },
    • "sys_utcinserted": "2019-08-24T14:15:22Z",
    • "sys_utcupdated": "2019-08-24T14:15:22Z"
    }
}
Response samples
application/json
{
  • "person": {
    • "identifications": [
      • {
        • "govt_id_type": "NOTPROVIDED",
        • "govt_id_number": "string"
        }
      ],
    • "person_guid": "2ae6ba4b-f6c0-4817-a158-43e5a87168fd",
    • "birth_date": "string",
    • "email": "string",
    • "first_name": "string",
    • "middle_name": "string",
    • "last_name": "string",
    • "additional_data": {
      • "property1": "string",
      • "property2": "string"
      },
    • "mobile_number": "string",
    • "home_number": "string",
    • "office_number": "string",
    • "base_address": {
      • "city": "string",
      • "country": "str",
      • "address_line1": "string",
      • "address_line2": "string",
      • "postal_code": "string",
      • "state": "string"
      },
    • "mailing_address": {
      • "city": "string",
      • "country": "str",
      • "address_line1": "string",
      • "address_line2": "string",
      • "postal_code": "string",
      • "state": "string"
      },
    • "billing_address": {
      • "city": "string",
      • "country": "str",
      • "address_line1": "string",
      • "address_line2": "string",
      • "postal_code": "string",
      • "state": "string"
      },
    • "nationality": "str",
    • "ip_address": "string",
    • "person_status": "INCOMPLETE",
    • "client_reference_id": "string",
    • "verfication_mode": "string",
    • "verfication_level": "string",
    • "person_forget_mode": "string",
    • "person_forget_mode_date": "string",
    • "market_notification_optin": "string",
    • "market_notification_optin_date": "string",
    • "address_lat": 0,
    • "address_lon": 0,
    • "contact_type": "string",
    • "profile_dd_mode": "string",
    • "request_code": "string",
    • "wallet_id": "string",
    • "title": "string",
    • "mask_govt_id_number": "string",
    • "comments": "string",
    • "jurisdiction_state": "string",
    • "jurisdiction_country": "str",
    • "beneficial_ownership": 100,
    • "person_relations": [
      • {
        • "holder_person_guid": "67b4ee47-03be-4fa4-8a21-68a2b2312803",
        • "related_person_guid": "ad395ead-8b71-46c4-b7c0-1c41ae432595",
        • "person_relationship": "string",
        • "sys_utcinserted": "2019-08-24T14:15:22Z",
        • "sys_utcupdated": "2019-08-24T14:15:22Z"
        }
      ],
    • "mask_account_number": "string",
    • "ledger_balance": 0,
    • "program_guid": "3fa0d2ea-ffcf-485d-94ed-dbf4f861ad2f"
    },
  • "card": {
    • "card_number": "string",
    • "card_proxy": "string",
    • "mask_card_pan": "string",
    • "wallet_guid": "17eaeda9-c0ab-4ac3-8ef9-27ac9b388a03",
    • "wallet_id": "string",
    • "issuance_type": "FULL",
    • "base_iin": "string",
    • "card_condition": "ORIGINAL",
    • "card_status": "ACTIVE",
    • "activation_date": "2019-08-24T14:15:22Z",
    • "activation_method": "ONLOAD",
    • "expiration_date": "string",
    • "cvx2": "string",
    • "logical_expiration_date": "2019-08-24T14:15:22Z",
    • "person_card_status": "ACTIVE",
    • "card_tracking_detail": {
      • "fulfillment_house_name": "string",
      • "card_requested": "2019-08-24T14:15:22Z",
      • "card_shipment_date": "2019-08-24T14:15:22Z",
      • "card_delivery_method": "string",
      • "card_delivery_tracking_number": "string",
      • "card_package_name": "string",
      • "card_order_status": "string",
      • "digital_package_name": "string",
      • "digital_package_id": "string"
      },
    • "status_change_nonmon_detail": {
      • "nonmon_guid": "3df16cd2-de7f-4e81-936e-7604855d1fd7",
      • "txn_date": "2019-08-24T14:15:22Z",
      • "channel_name": "string",
      • "request_code": "string",
      • "reason_code": "string",
      • "response_code": "string",
      • "person_guid": "2ae6ba4b-f6c0-4817-a158-43e5a87168fd",
      • "hash_account_number": "string",
      • "remarks": "string",
      • "account_guid": "d2b7c9d2-85e7-4c51-92d0-3f97a47f8d76",
      • "journal_guid": "019b8be6-224f-4e54-91ec-2a471754d334",
      • "support_user_guid": "334ad5b0-1427-4c28-aac8-2d6e9614b4d0",
      • "source_code": "string",
      • "source_user_guid": "0aaedba8-146e-40a6-ad5f-54c512699647",
      • "reference_number": "string",
      • "outsort_guid": "eef602a5-424d-4eae-b4d8-4521969d8873",
      • "order_guid": "dd878538-67b6-4e7d-8e8a-ddc3e971d02f",
      • "processing_start_date": "2019-08-24T14:15:22Z",
      • "processing_end_date": "2019-08-24T14:15:22Z"
      },
    • "sys_utcinserted": "2019-08-24T14:15:22Z",
    • "sys_utcupdated": "2019-08-24T14:15:22Z"
    }
}
Copyright © 2023 KeyBank & Qolo. All rights reserved.