Description
The updateToken request will be used to modify existing transaction data.
...
The method will return the operation result.
Variables to send:
Parameter | Data type | Description | |
Request | Text | updateToken | Mandatory |
CompanyToken | Token | Token you got from 3G to operate this API | Mandatory |
TransactionToken | Token | Transaction token as accepted from the createToken. | Mandatory |
PaymentAmount | money | Transaction amount, up to 2 decimal | Optional |
| CompanyRef | Text | Company reference number | Optional |
| CustomerEmail | Text | E-mail of the customer to send the link | Optional |
| CustomerFirstName | Text | Customer name | Optional |
| CustomerLastName | Text | Customer last name | Optional |
| CustomerAddress | Text | Customer address | Optional |
| CustomerCity | Text | Customer city | Optional |
| CustomerCountry | ISO code | Customer country ISO 2 letter code http://en.wikipedia.org/wiki/ISO_3166-1 | Optional |
| CustomerDialCode | ISO code | Customer country ISO 2 letter code http://en.wikipedia.org/wiki/ISO_3166-1 | Optional |
| CustomerPhone | Number | Customer Phone number | Optional |
| CustomerZip | Text | Customer zip code | Optional |
| CompanyAccRef | Text | Internal accounting reference number | Optional |
| UserToken | Token | To define who created the transaction | Optional |
Request example:
| Code Block | ||||
|---|---|---|---|---|
| ||||
<?xml version="1.0" encoding="utf-8"?> <API3G> <CompanyToken>68B90B5E-25F6-4146-8AB1-C7A3A0C41A7F</CompanyToken> <Request>updateToken</Request> <TransactionToken>EC9E975A-A7A2-4031-8972-BF123CDD9EDD</TransactionToken> <PaymentAmount>44</PaymentAmount> <CompanyRef>DPO1212</CompanyRef> <CustomerEmail>test@directpay.online</CustomerEmail> <CustomerFirstName>Steven dsa</CustomerFirstName> <CustomerLastName>Muallem</CustomerLastName> <CustomerAddress>Rose Avenue 6 </CustomerAddress> <CustomerCity>Nairobi</CustomerCity> <CustomerCountry>KE</CustomerCountry> <CustomerDialCode>KE</CustomerDialCode> <CustomerPhone>4433332312</CustomerPhone> <CustomerZip>121212</CustomerZip> <CompanyAccRef>DPO3232</CompanyAccRef> <UserToken>3DBC6853-8352-4902-8370-C6B38C379999E</UserToken> </API3G> |
Respond:
The server will respond for the updateToken request according to the following results:
Parameter | Data type | Description |
Result | 3 digits code | A code will be sent with the result of the request |
ResultExplanation | Text | Free text of the result |
Respond codes:
Code | Explanation |
000 | Token been updated |
999 | Custom error message |
804 | Error in XML |
950 | Request missing transaction level mandatory fields |
Respond example:
| Code Block | ||||
|---|---|---|---|---|
| ||||
<?xml version="1.0" encoding="utf-8"?>
<API3G>
<Result>000</Result>
<ResultExplanation>Token been updated</ResultExplanation>
</API3G> |
...