Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 2 Next »

Usage


Retrieves a token and a URL which allows you to redirect the customer to a form to process a real-time casual 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.

Parameters

Name

Data Type

Length


Description

User





  • Username

String


Required

Provided by Debitsuccess

  • Password

String


Required

Provided by Debitsuccess

ContractPrefix

String


Required

Provided by Debitsuccess

Amount

Decimal

(10,2)


Required

Amount to pay


PaymentNote

String

30

Optional

Any notes to be recorded against the payment

PaymentRef

String

50

Optional


CallbackURL

String

256

Required

The URL the customer needs to be redirected to after the operation

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


  • Code

String



  • Note

String



  • NoteType

Enum

Error, Warning, Info


Status

Enum

Failed, Succeed, Unknown


Token

String

Auto-generated token

16 Characters

WebhookToken

String

Auto-generated webhook token

16 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, PaymentFormToken, Status, Message, ResponseCode.

We recommend that you store the WebhookToken we provide in the response securely to authenticate the information received through the WebhookURL is from Debitsuccess.

Note:

The webhook URL must be registered in the facility.CasualPaynowWebHookUrl column


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, Status, Message

​Declined

http://www.debitsuccess.com/?Status=Declined&Token=QyqqjL0G&Message=DO%20NOT%20HONOUR

Payment successful

Token, Status, Message (blank)

Success

http://www.debitsuccess.com/?Status=Success&Token=TGhZfWjb&Message=

Payment failed


Error

http://www.debitsuccess.com/?Status=Error&Token=TGhZfWjb&Message=

Contract Prefix validation field


ContractPrefixInvalid

http://www.debitsuccess.com/?Status=ContractPrefixInvalid&Token=TGhZfWjb&Message=

Load of payment details successful


Success

http://www.debitsuccess.com/?Status=Success&Token=TGhZfWjb&Message=

Load of payment details failed


Failure

http://www.debitsuccess.com/?Status=Failure&Token=TGhZfWjb&Message=

Token expired

Token, Status, Message (blank)

TokenExpired

http://www.debitsuccess.com/?Status=TokenExpired&Token=TGhZfWjb&Message=

Error Messages

Need info

On this page:

Related pages

Filter by label

There are no items with the selected labels at this time.



  • No labels