== 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
require_once "curl_http_client/curl_http_client.php";
$curl = new Curl_HTTP_Client();
//setup payment url and timeout
$payment_url = 'https://dev-payment.datingvip.com';
$timeout = 30;
//generate post data
$post_data = array
(
'token' => 'some-token',
'password' => '130d0412344196857e47b254ebfbb53f',
'command' => 'cards.list',
'data' => array(
'tracking_user' => 1,
'currency' => 'USD',
'status' => 'active',
'pp_type' => 'RG'
)
);
$response = $curl->send_post_data($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=9)
'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 '1' (length=1)
'name' => string 'Dragan Dinic' (length=12)
'ccnum' => string '412800xxxxxx7113' (length=16)
'exp_date' => string '2015-12-01' (length=10)
'cc_type' => string 'visa' (length=4)
'transaction_id' => string '1' (length=1)
'status' => string 'active' (length=6)
'currency' => string 'EUR' (length=3)
'request' =>
array (size=4)
'token' => string 'some-token' (length=30)
'password' => string '130d04b80a4196857e47b254ebfbb53f' (length=32)
'command' => string 'cards.list' (length=10)
'data' =>
array (size=1)
'tracking_user' => string '1' (length=1)
'ts' => int 1399573740
'origin_ip' => boolean false
'debug' => null
'errors' => null
```