Update transaction information for checkout
Updates an in-progress checkout request. This can be used to add a total amount or to fill in additional details such as invoice, description, etc. updateCheckOut can be called repeatedly up until the customer has confirmed the amount.
updateCheckOut ( ueSecurityToken Token, string RequestID, CheckOutRequest Request)
Type | Name | Description |
---|---|---|
ueSecurityToken | Token | Merchant security token: used to identify merchant and retrieve the custom fields. |
string | RequestID | ID of checkout request that was returned by startCheckOut |
CheckOutRequest | Detail | Transaction detail for checkout request |
string | RequestID | ID of checkout request for confirmation |
The following exceptions (errors) are applicable to this method.
Code | Message | Advice |
---|---|---|
21100 | There are no POS devices associated with this source key | Register a pos device to this source key |
21101 | POS device offline | Device associated with this source key is offline, try rebooting |
21105 | Check out can no longer be updated | The checkout was cancelled or an error occurred. A new checkout request should be started with startCheckOut |
21106 | Transaction already processed, amount can't be updated | Checkout process has already passed the amount confirmation screen. Use adjustTransaction to make a change before settlement. |
For directions on how to set up the WSDL link, create “$token” and “$client”, go to PHP Soap How-to.
Request:
<?xml version="1.0" encoding="UTF-8"?> <SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="https://www-stage.usaepay.com/soap/2.0/uedocs"> <SOAP-ENV:Body> <ns1:updateCheckOut> <Token> <ClientIP>192.168.0.1</ClientIP> <PinHash> <HashValue>b19be1aba51d38ac7ba0daf0567d9bc3e31d903d</HashValue> <Seed>13651908061679743807</Seed> <Type>sha1</Type> </PinHash> <SourceKey>e42SYc86C4uvlvyP62ow54Kv93SZsJVm</SourceKey> </Token> <RequestID>192988538</RequestID> <Request> <Details> <Amount>9.95</Amount> <Invoice>123311</Invoice> </Details> </Request> </ns1:updateCheckOut> </SOAP-ENV:Body> </SOAP-ENV:Envelope>
Response:
Version | Change |
---|---|
1.6 | Method added in this release |