Copy payment info
Overview
Copy card-on-file data available in the Avangate system from a source subscription to an imported target subscription. Avangate uses the existing payment information to charge customers as a part of the recurring billing (renewal) process.
Use the copyPaymentInfo method.
Requirements
The imported target subscription and the source subscription must belong to the same customer. The Avangate system checks to make sure that the Avangate Customer Reference (internal identifier) coincides for the customer accounts associated to the target and source subscriptions.
Availability
Please contact Avangate directly if you wish to take advantage of this feature.
How does this method work?
- Customer A purchases Subscription A using a VISA credit card and you import Subscription B for the same customer with no data or with an AMEX card.
- When Avangate renews Subscription A, it charges Customer A using the VISA, while using the AMEX (if the data was provided) for Subscription B charges.
- When you copy the payment data from Subscription A to Subscription B, the Avangate system uses the VISA credit card to renew both subscriptions according with their respective recurring billing cycles. Avangate charges customers during the recurring billing process for the imported target subscription using the payment method they used to purchase the source subscription.
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. |
TargetSubscriptionReference |
Required (string) |
The Avangate Subscription Reference of the imported target subscription, to which Avangate copies the payment on file data associated with the source subscription. |
|
SubscriptionReference |
Required (string) |
|
The Avangate Subscription Reference of the source subscription whose attached payment on file data Avangate copies to the target subscription. |
Request
<?php
require ('PATH_TO_AUTH');
var_dump($sessionID);
$TargetSubscription = 'FFAE3C9429';
$SourceSubscription = '9F4154733C';
$jsonRpcRequest = array (
'method' => 'copyPaymentInfo',
'params' => array($sessionID, $TargetSubscription, $SourceSubscription),
'id' => $i++,
'jsonrpc' => '2.0');
var_dump (callRPC((Object)$jsonRpcRequest, $host, true));
?>
Response
Parameter | Type/Description |
---|---|
Boolean |
true or false depending on whether or not the operation succeeded. |