Skip to main content

Retrieve a customer

Last updated: 12-Aug-2025
Rate this article:

Overview

Use the getCustomerInformation method to retrieve the details of a customer entity from the Avangate system.

Parameters

Parameters Type/Description
sessionID Required (string)
  Session identifier, the output of the Login method. Include sessionID into all your requests. Avangate throws an exception if the values are incorrect.  The sessionID expires in 10 minutes.
AvangateCustomerReference Required (int)
  System-generated customer reference. Required unless you prefer to use ExternalCustomerReference.
ExternalCustomerReference Optional (string)
  External customer reference that you control. Optional when you use AvangateCustomerReference. If you include it, it needs to belong to the same customer as the AvangateCustomerReference.

Request

<?php

require ('PATH_TO_AUTH');

$customerReference = CUSTOMER_REFERENCE;
$externalCustomerReference = 'EXT_CUSTOMER_REFERENCE'; // Optional, but if you include it it needs to belong to the same customer as the internal Avangate customer reference

$jsonRpcRequest = array(
    'method' => 'getCustomerInformation',
    'params' => array($sessionID, $customerReference, $externalCustomerReference),
    'id' => $i++,
    'jsonrpc' => '2.0'
);

$customerInfo = callRPC((Object)$jsonRpcRequest, $host, true);

// Add Credit object (if you want to manipulate or send it later)
$customerInfo->Credit = new stdClass();
$customerInfo->Credit->Limit = 51.0;
$customerInfo->Credit->Remaining = 21.0;
$customerInfo->Credit->Currency = 'EUR';

var_dump($customerInfo);

Response

Parameters Type/Description
Customer Object
Rate this article:

Need help?

Do you have a question? If you didn’t find the answer you are looking for in our documentation, you can contact our Support teams for more information. If you have a technical issue or question, please contact us. We are happy to help.

Not yet a Verifone customer?

We’ll help you choose the right payment solution for your business, wherever you want to sell, in-person or online. Our team of experts will happily discuss your needs.

Verifone logo