Versions Compared
Key
- This line was added.
- This line was removed.
- Formatting was changed.
Usage
| Excerpt |
|---|
Retrieves a token and a URL which allows you to redirect the customer to a form to either capture new payment details (bank account or credit card) or process a real-time payment. |
At the end of the operation, the user will be redirected to the call back URL provided in the request message and the status of the operation will be returned as a URL parameter. The token has a lifespan of 10 minutes. This will mean that the customer needs to access the payment form URL within 10 minutes of the token being issued. The token is for one-time usage. Once the operation has started (link is clicked), it cannot be reused.
| Info | ||
|---|---|---|
| ||
We recommend that this message should be used in conjunction with the message GetCardPaymentStatusForCustomerAccount for confirmation of payment. |
Parameters
Name | Data Type | Description | |
|---|---|---|---|
User | |||
| String | Required | Provided by Debitsuccess |
| String | Required | Provided by Debitsuccess |
RequestInitiator | String | Optional | Optional – allows requesting user to be logged |
AccountReferenceNo | String | Optional* | Debitsuccess Reference number |
ExternalAccountReferenceNo | String | Optional* | Your account identifier |
​PayMethodType | ​Enum | Required | ​CreditCard - allows user to save CC details BankAccount - allows user to save bank account details Both - Allows user to save either bank account or CC details |
​Amount | Decimal(10,2) | ​Optional** | ​Amount to pay Current validation restricts this to $2000 per transaction and only placing the account up to $500 in credit. |
​RequestType | ​Enum | ​Required | ​RealTimePayment - Allows token to be used for making a real time payment using CC and/or save payment details UpdatePaymentDetail - Allows token to be used for adding payment details |
​CreateOneOffCharge | Boolean | ​Required | ​true – If a payment is successful, a one-off schedule will be created for the Amount false – If the payment is successful, Amount will be allocated to account balance |
​PaymentNote | ​String | Optional​*** | ​Any notes to be recorded against the payment. Limited to 30 characters. |
​CallbackURL | ​String | ​Required | ​The URL the customer needs to be redirected to after the operation |
* At least one of the following parameters must be supplied: AccountReferenceNo, ExternalAccountReferenceNo
** Required if the request type is a real-time payment
*** Required if CreateOneOffCharge is set to true
ResponseÂ
Name | Data Type | Description | Maximum Length |
|---|---|---|---|
DateCreated | DateTime | Date/time message was processed | ​ |
Id | String | Unique ID for the message | ​ |
ResponseNotes () | Collection of validation messages | ​ | |
| String | ​ | |
| String | ​ | |
| Enum | Error, Warning, Info | ​ |
Status | Enum | Failed, Succeed, Unknown | ​ |
GetPaymentToken() | ​ | ||
Token | String | Auto-generated token | ​8 characters |
WebhookToken | String | Auto-generated webhook token | 8 characters |
ValidTo | Datetime |  Expiry date of the token | ​ |
PaymentFormURL | String | URL where customer can make a payment or update payment details. It will have the token appended |
Webhook URL
For each facility, you can provide a Webhook URL which, after approval, we will store in our database. We will post the transaction details to this Webhook URL once as a JSON object. The transaction details are the same as what we send back for CallbackURL - the WebhookToken, AccountReferenceNo, ExternalAccountReferenceNo, Status and Message.Â
| Info | ||
|---|---|---|
| ||
| We recommend that you store the WebhookToken we provide in the response securely to authenticate the information received through the WebhookURL is from Debitsuccess. |
When a customer is redirected to the call back URL, the following response fields will be appended in the URL.
Scenario | Response Fields | ​Status Description | Example |
|---|---|---|---|
Payment declined | Token, AccountReferenceNo, ExternalAccountReferenceNo, Status, Message | ​Declined | http://www.debitsuccess.com/?Status=Declined&Token=QyqqjL0G&AccountReferenceNo=TST4887235&ExternalAccountReferenceNo=BMWHSHS888300&Message= DO%20NOT%20HONOUR |
Payment successful | Token, AccountReferenceNo, ExternalAccountReferenceNo, Status, Message (blank) | ​Success | http://www.debitsuccess.com/?Status=Success&Token=TGhZfWjb&AccountReferenceNo=TST4888608&ExternalAccountReferenceNo=BMWHSHS888300&Message= |
Payment failed | Token, AccountReferenceNo, ExternalAccountReferenceNo, Status, Message (blank) | ​Error | http://www.debitsuccess.com/?Status=Error&Token=56vNqgkE&AccountReferenceNo=TST4888608&ExternalAccountReferenceNo=BMWHSHS888300&Message= |
Account validation failed | Token, AccountReferenceNo, ExternalAccountReferenceNo, Status, Message (blank) | AccountIsNotValid | http://www.debitsuccess.com/?Status=AccountIsNotValid&Token=YxLJ87En&AccountReferenceNo=TST4888608&ExternalAccountReferenceNo=BMWHSHS888300&Message= |
Load of payment details successful | Token, AccountReferenceNo, ExternalAccountReferenceNo, Status, Message (blank) | ​Success | http://www.debitsuccess.com/?Status=Success&Token=4x2Mz9bG&AccountReferenceNo=TST4888608&ExternalAccountReferenceNo=BMWHSHS888300&Message= |
Load of payment details failed | Token, AccountReferenceNo, ExternalAccountReferenceNo, Status, Message (blank) | ​Failure | http://www.debitsuccess.com/?Status=Failure&Token=3yFZiMrJ&AccountReferenceNo=TST4888608&ExternalAccountReferenceNo=BMWHSHS888300&Message= |
Token expired | Token, AccountReferenceNo (blank), ExternalAccountReferenceNo (blank), Status, Message (blank) | ​TokenExpired | http://www.debitsuccess.com/?Status=TokenExired&Token=AsYMNsTf&AccountReferenceNo=&ExternalAccountReferenceNo=&Message= |
Error Messages
Need info
| Type | Error Code | Error Message |
|---|---|---|
Related Pages
| Filter by label (Content by label) | ||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
| Panel | |
|---|---|
On this page:
|