API: Virtual Terminal

Recharge provides an easy way to submit one-time credit card charges from your application.

These transactions do not leverage stored credit cards or customers, so you're free to use these without having to worry about adding a customer every time.

 

Credit Card Purchase

POST /purchase

Charges the specified credit card for the specified amount.

Request

$fields['customer'] = "cu4e8adefb8c96f"; // not required 
$fields['Amount'] = "1.00"; 
$fields['AcctNum'] = "4111111111111111"; 
$fields['ExpDate'] = "1212"; 
$fields['CardCode'] = "999"; // not required 
$fields['Address'] = "123 Any St"; // not required 
$fields['ZipCode'] = "90210"; // not required 
$fields['UserID'] = "Clerk"; // not required 
$fields['TrackingID'] = "123456789"; // not required 

Response

<transaction>
	<responseCode>000</responseCode> 
	<responseDescription>Approval</responseDescription>   
	<transactionID>000000000587</transactionID> 
	<amount>1.00</amount> 
	<cardType>Visa</cardType> 
	<maskedAcctNum>************1111</maskedAcctNum> 
	<expDate>1212</expDate> 
	<processorResponse>DEVELOPMENT APPROVAL</processorResponse> 
	<batchNum>000024</batchNum> 
	<batchAmount>1.00</batchAmount> 
	<approvalCode>748938</approvalCode> 
</transaction>

 

Credit Card Return

POST /return

Returns money to the specified credit card for the specified amount.

Request

$fields['Amount'] = "1.00"; 
$fields['AcctNum'] = "4111111111111111"; 
$fields['ExpDate'] = "1212"; 
$fields['UserID'] = "Clerk"; // not required 
$fields['TrackingID'] = "123456789"; // not required 

Response

<transaction>
	<responseCode>000</responseCode> 
	<responseDescription>Approval</responseDescription>   
	<transactionID>000000000588</transactionID> 
	<amount>1.00</amount> 
	<cardType>Visa</cardType> 
	<maskedAcctNum>************1111</maskedAcctNum> 
	<expDate>1212</expDate> 
	<processorResponse></processorResponse> 
	<batchNum>000024</batchNum> 
	<batchAmount>1.00</batchAmount> 
	<approvalCode></approvalCode> 
</transaction>

 

Credit Card Void

POST /void

Voids a previously processed transaction using a transaction ID.

Request

$fields['TransactionID'] = "000000000445"; 

Response

<transaction>
	<responseCode>000</responseCode> 
	<responseDescription>Approval</responseDescription>   
	<transactionID>000000000445</transactionID> 
	<amount>1.00</amount> 
	<cardType>Visa</cardType> 
	<maskedAcctNum>************1111</maskedAcctNum> 
	<expDate>1212</expDate> 
	<processorResponse></processorResponse> 
	<batchNum>000024</batchNum> 
	<batchAmount>1.00</batchAmount> 
	<approvalCode></approvalCode> 
</transaction>