Retrieve a receipt for a transaction
This method allows you to render a receipt template for a given transaction.
RefNum referers to the gateway assigned transaction identifier. ReceiptRefNum refers to the gateway assigned ID for the receipt. ContentType refers to the type of receipt requested.
Returns base64 encode receipt. If an error occurs, an exception will be thrown.
See also renderReceiptByName
string renderReceipt ( ueSecurityToken, RefNum, ReceiptRefNum, ContentType )
Type | Name | Description |
---|---|---|
ueSecurityToken | Token | Merchant security token: used to identify merchant and retrieve the custom fields. |
integer | RefNum | Gateway assigned transaction ID |
integer | ReceiptRefNum | Gateway assigned receipt ID |
string | ContentType | Format of receipt (HTML or Text) |
string | Returns base64 encoded receipt |
The following exceptions (errors) are applicable to this method.
Code | Message | Advice |
---|---|---|
20001 | Specified transactions was not found | Specified RefNum does not match a transaction for this merchant. |
20030 | Requested receipt not found | ReceiptRefNum must match an existing receipt. |
20031 | Invalid content type | ContentType must be either Text, HTML or Both |
For directions on how to set up the WSDL link, create “$token” and “$client”, go to PHP Soap How-to.
<?php try { $ReceiptRefNum = 2; $RefNum = 1102910; $receipt = $client->renderReceipt($token, $RefNum, $ReceiptRefNum, "HTML"); $receipt = base64_decode($receipt); } catch(SoapFault $e) { echo $e->getMessage(); } ?>
For directions on how to set up the WSDL link and create the “token” and “client” variables, go to the Visual Basic .Net Soap How-to.
Dim receiptNum As String receiptNum = "6" Dim refNum As String refNum = "46981789" Dim contentType As String contentType = "text" Dim response As String response = client.renderReceipt(token, refNum, receiptNum, contentType) Dim todecode As Byte() todecode = Convert.FromBase64String(response) MsgBox(System.Text.Encoding.UTF8.GetString(todecode))
For directions on how to set up the WSDL link and create the “token” and “client” variables, go to the C Sharp .Net Soap How-to.
string refNum = "46981789"; string receiptRefNum = "6"; string ContentType = "text"; string response; try { response = client.renderReceipt(token, refNum, receiptRefNum, ContentType); byte[] todecode = Convert.FromBase64String(response); MessageBox.Show(string.Concat(System.Text.Encoding.UTF8.GetString(todecode))); } catch (Exception err) { MessageBox.Show(err.Message); }
Request:
Response:
Version | Change |
---|---|
1.3 | Method added in this release |