== cards.list ==
==== Description ====
Retrieve records of stored credit cards
==== Input Parameters ====
<table>
<tr><th>Name</th><th>Type</th><th>Required</th><th>Description</th></tr>
<tr><td>tracking_user</td><td>mixed (int|array)</td><td>Yes</td><td>Client application user ID(s)</td></tr>
<tr><td>card_type</td><td>mixed (string|array)</td><td>No</td><td>Show only results for specified card type</td></tr>
<tr><td>currency</td><td>mixed (string|array)</td><td>No</td><td>Show only results for specified currency</td></tr>
<tr><td>status</td><td>mixed (string|array)</td><td>No</td><td>Show only results for specified card status</td></tr>
<tr><td>ccdt_id</td><td>int</td><td>No</td><td>Show only results for specified card ID</td></tr>
<tr><td>pp_type</td><td>mixed (string|array)</td><td>No</td><td>Show only results for specified payment processor type (RG, NB etc.)</td></tr>
<tr><td>ccnum</td><td>string</td><td>No</td><td>Show only results for specified card number</td></tr>
</table>
==== Returned ====
Array with these data in each array
<table>
<tr><th>Name</th><th>Type</th><th>Description</th></tr>
<tr><td>ccdt_id</td><td>int</td><td>PV2 ccdt_id</td></tr>
<tr><td>name</td><td>string</td><td>Name on CC</td></tr>
<tr><td>exp_date</td><td>string</td><td>expire date</td></tr>
<tr><td>cc_type</td><td>string</td><td>cc_type</td></tr>
<tr><td>transaction_id</td><td>int</td><td>pv2 transaction_id</td></tr>
<tr><td>status</td><td>string</td><td>status (active|inactive|expired)</td></tr>
<tr><td>currency</td><td>string</td><td>currency</td></tr>
</table>
==== Usage Example ====
```
<?php
$curl = new \Dinke\CurlHttpClient;
//setup payment url and timeout
$payment_url = 'https://dev-payment.datingvip.com/api.json';
$timeout = 30;
$curl->setCredentials('some-token', 'some-pass');
$post_data = array(
'cmd' => 'cards.list',
'data' => array(
'tracking_user' => 10166584,
'currency' => 'USD',
'status' => 'active',
'pp_type' => 'RG'
)
);
$response = $curl->sendPostData($payment_url, $post_data, null, $timeout);
if($response === false)
{
//handle errors
}
//decode json to get array
$response = json_decode($response, true);
var_dump($response);
?>
```
Excepted output after running this script should be:
```
array (size=1)
'result' =>
array (size=8)
'code' => int 700
'status' => string 'Action completed succesfully' (length=28)
'command' => string 'cards.list' (length=10)
'result' =>
array (size=1)
0 =>
array (size=8)
'ccdt_id' => string '393' (length=3)
'name' => string 'Nerty Ben' (length=9)
'ccnum' => string '413415xxxxxx4135' (length=16)
'exp_date' => string '2016-03-01' (length=10)
'cc_type' => string 'visa' (length=4)
'transaction_id' => string '1980' (length=4)
'status' => string 'active' (length=6)
'currency' => string 'USD' (length=3)
'request' =>
array (size=4)
'cmd' => string 'cards.list' (length=10)
'data' =>
array (size=4)
'tracking_user' => string '10166584' (length=8)
'currency' => string 'USD' (length=3)
'status' => string 'active' (length=6)
'pp_type' => string 'RG' (length=2)
'token' => string 'some-token' (length=26)
'pass' => string 'some-pass' (length=32)
'ts' => int 1429544480
'origin_ip' => string '93.87.220.184' (length=13)
'errors' => null
```