Skip to content

Latest commit

 

History

History
225 lines (177 loc) · 8 KB

TokenVault.md

File metadata and controls

225 lines (177 loc) · 8 KB
Raw

TokenVault

Method HTTP request Description
PGCustomerDeleteInstrument Delete /customers/{customer_id}/instruments/{instrument_id} Delete Saved Card Instrument
PGCustomerFetchInstrument Get /customers/{customer_id}/instruments/{instrument_id} Fetch Specific Saved Card Instrument
PGCustomerFetchInstruments Get /customers/{customer_id}/instruments Fetch All Saved Card Instrument
PGCustomerInstrumentsFetchCryptogram Get /customers/{customer_id}/instruments/{instrument_id}/cryptogram Fetch cryptogram for a saved card instrument

PGCustomerDeleteInstrument

PGCustomerDeleteInstrument($x_api_version, $customer_id, $instrument_id, $x_request_id = null, $x_idempotency_key = null, GuzzleHttp\Client $http_client = null)

Delete Saved Card Instrument (Docs)

Example

$x_api_version = "2022-09-01";
$customer_id = "customer_id";
$instrument_id = "instrument_id";
try {
  $result = $cashfree->PGCustomerDeleteInstrument($x_api_version, $customer_id, $instrument_id, null, null, null);
} catch (Exception $e) {
  echo 'Exception when calling PGCustomerDeleteInstrument: ', $e->getMessage(), PHP_EOL;
}

Parameters

Name Type Description Notes
customerId string* Your Customer ID that you had sent during create order API `POST/orders`
instrumentId string* The instrument_id which needs to be deleted
xApiVersion string* API version to be used. Format is in YYYY-MM-DD [default to "2022-09-01"]
xRequestId string Request id for the API call. Can be used to resolve tech issues. Communicate this in your tech related queries to cashfree

Response

{
  "customer_id": "siddhesh_desai",
  "afa_reference": "740324562",
  "instrument_id": "54deabb4-ba45-4a60-9e6a-9c016fe7ab10",
  "instrument_type": "card",
  "instrument_uid": "0d8f70838cc5af8b1cd2bc0fe71278551fd3f1101e40020d89ad22ceba4f933c",
  "instrument_display": "xxxxxxxxxxxx4375",
  "instrument_status": "ACTIVE",
  "created_at": "2021-11-11 16:57:57",
  "instrument_meta": {
    "card_network": "VISA",
    "card_bank_name": "HDFC Bank Limited",
    "card_country": "IN",
    "card_type": "DEBIT_CARD",
    "card_token_details": {
      "par": "somepar",
      "expiry_month": "12",
      "expiry_year": "23"
    }
  }
}

PGCustomerFetchInstrument

PGCustomerFetchInstrument($x_api_version, $customer_id, $instrument_id, $x_request_id = null, $x_idempotency_key = null, GuzzleHttp\Client $http_client = null)

Fetch Specific Saved Card Instrument (Docs)

Example

$x_api_version = "2022-09-01";
$customer_id = "customer_id";
$instrument_id = "instrument_id";
try {
  $result = $cashfree->PGCustomerFetchInstrument($x_api_version, $customer_id, $instrument_id, null, null, null);
} catch (Exception $e) {
  echo 'Exception when calling PGCustomerFetchInstrument: ', $e->getMessage(), PHP_EOL;
}

Parameters

Name Type Description Notes
customerId string Your Customer ID that you had sent during create order API `POST/orders`
instrumentId string The instrument_id of the saved instrument which needs to be queried
xApiVersion string API version to be used. Format is in YYYY-MM-DD [default to "2022-09-01"]
xRequestId string Request id for the API call. Can be used to resolve tech issues. Communicate this in your tech related queries to cashfree

Response

{
  "customer_id": "siddhesh_desai",
  "afa_reference": "740324562",
  "instrument_id": "54deabb4-ba45-4a60-9e6a-9c016fe7ab10",
  "instrument_type": "card",
  "instrument_uid": "0d8f70838cc5af8b1cd2bc0fe71278551fd3f1101e40020d89ad22ceba4f933c",
  "instrument_display": "xxxxxxxxxxxx4375",
  "instrument_status": "ACTIVE",
  "created_at": "2021-11-11 16:57:57",
  "instrument_meta": {
    "card_network": "VISA",
    "card_bank_name": "HDFC Bank Limited",
    "card_country": "IN",
    "card_type": "DEBIT_CARD",
    "card_token_details": {
      "par": "somepar",
      "expiry_month": "12",
      "expiry_year": "23"
    }
  }
}

PGCustomerFetchInstruments

PGCustomerFetchInstruments($x_api_version, $customer_id, $instrument_type, $x_request_id = null, $x_idempotency_key = null, GuzzleHttp\Client $http_client = null)

Fetch All Saved Card Instrument (Docs)

Example

$x_api_version = "2022-09-01";
$customer_id = "customer_id";
$instrument_type = "instrument_id";
try {
  $result = $cashfree->PGCustomerFetchInstruments($x_api_version, $customer_id, $instrument_type, null, null, null);
} catch (Exception $e) {
  echo 'Exception when calling PGCustomerFetchInstruments: ', $e->getMessage(), PHP_EOL;
}

Parameters

Name Type Description Notes
customerId string* Your Customer ID that you had sent during create order API `POST/orders`
xApiVersion string* API version to be used. Format is in YYYY-MM-DD [default to "2022-09-01"]
instrumentType string* Payment mode or type of saved instrument
xRequestId string Request id for the API call. Can be used to resolve tech issues. Communicate this in your tech related queries to cashfree

Response

[
  {
  "customer_id": "siddhesh_desai",
  "afa_reference": "740324562",
  "instrument_id": "54deabb4-ba45-4a60-9e6a-9c016fe7ab10",
  "instrument_type": "card",
  "instrument_uid": "0d8f70838cc5af8b1cd2bc0fe71278551fd3f1101e40020d89ad22ceba4f933c",
  "instrument_display": "xxxxxxxxxxxx4375",
  "instrument_status": "ACTIVE",
  "created_at": "2021-11-11 16:57:57",
  "instrument_meta": {
    "card_network": "VISA",
    "card_bank_name": "HDFC Bank Limited",
    "card_country": "IN",
    "card_type": "DEBIT_CARD",
    "card_token_details": {
      "par": "somepar",
      "expiry_month": "12",
      "expiry_year": "23"
    }
  }
}
]

PGCustomerInstrumentsFetchCryptogram

PGCustomerInstrumentsFetchCryptogram($x_api_version, $customer_id, $instrument_id, $x_request_id = null, $x_idempotency_key = null, GuzzleHttp\Client $http_client = null)

Fetch cryptogram for a saved card instrument (Docs)

Example

$x_api_version = "2022-09-01";
$customer_id = "customer_id";
$instrument_type = "instrument_type";
try {
  $result = $cashfree->PGCustomerInstrumentsFetchCryptogram($x_api_version, $customer_id, $instrument_type, null, null, null);
} catch (Exception $e) {
  echo 'Exception when calling PGCustomerInstrumentsFetchCryptogram: ', $e->getMessage(), PHP_EOL;
}

Parameters

Name Type Description Notes
customerId string* Your Customer ID that you had sent during create order API `POST/orders`
instrumentId string* The instrument_id of the saved card instrument which needs to be queried
xApiVersion string* API version to be used. Format is in YYYY-MM-DD [default to "2022-09-01"]
xRequestId string Request id for the API call. Can be used to resolve tech issues. Communicate this in your tech related queries to cashfree

Response

{
  "instrument_id": "54deabb4-ba45-4a60-9e6a-9c016fe7ab10",
  "token_requestor_id": "22457512314",
  "card_number": "4491365621601472",
  "card_expiry_mm": "06",
  "card_expiry_yy": "2025",
  "cryptogram": "AQBBBBBBZatIlaIAmWKSghwBBBB=",
  "card_display": "1234"
}