Update customer's payment method
To reduce the level of assessment you may require for PCI, it is recommended to use the Payment Method Capture Widget or GetPaymentToken message when signing up customers or updating their payment method information.
REST API
Using the Widget
Use the Payment Method Capture Widget to securely capture payment details (credit card and bank account) by embedding it in your website and save payment details in Debitsuccess systems.
https://oc.debitsuccess.com/dswidget/dsPaymentFormWidget.js
SOAP WS
Change the payment method used to collect payments for an Account or make changes to the customer’s payment method. This can be achieved by the AdjustAccountPaymentMethod or the GetPaymentToken message.
Update payment method using GetPaymentToken (PayNow)
The GetPaymentToken retrieves an 8 digit token. This token can then been passed through the various wireless networks needed to process the payment without actual bank or credit card details being exposed. You will need to provide:
AccountReferenceNo
CallBackUrl
PayMethodType
RequestType
Choose UpdatePaymentDetail. This allows token to be used for adding payment details
Sample request message
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:deb="Debitsuccess.WebServices.WCF" xmlns:deb1="http://schemas.datacontract.org/2004/07/Debitsuccess.WebServices.Core" xmlns:deb2="http://schemas.datacontract.org/2004/07/Debitsuccess.WebServices.Core.RequestMessages">
<soapenv:Header/>
<soapenv:Body>
<deb:GetPaymentToken>
<deb:request>
<deb1:DateCreated>2020-09-22</deb1:DateCreated>
<deb1:Id>333</deb1:Id>
<deb1:RequestInitiator>Kin333</deb1:RequestInitiator>
<deb1:User>
<deb1:Id>33333</deb1:Id>
<deb1:Password>#password</deb1:Password>
<deb1:Username>username</deb1:Username>
</deb1:User>
<deb1:AccountReferenceNo>DEA2884487</deb1:AccountReferenceNo>
<deb1:ExternalAccountReferenceNo></deb1:ExternalAccountReferenceNo>
<deb2:CallBackUrl>https://www.testserver.debitsuccess.com</deb2:CallBackUrl>
<deb2:PayMethodType>Both</deb2:PayMethodType>
<deb2:RequestType>UpdatePaymentDetail</deb2:RequestType>
</deb:request>
</deb:GetPaymentToken>
</soapenv:Body>
</soapenv:Envelope>Sample response message
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
<s:Header>
<ActivityId CorrelationId="07d31e0f-0a6e-4e96-b5fc-2fa066db3c6b" xmlns="http://schemas.microsoft.com/2004/09/ServiceModel/Diagnostics">00000000-0000-0000-0000-000000000000</ActivityId>
</s:Header>
<s:Body>
<GetPaymentTokenResponse xmlns="Debitsuccess.WebServices.WCF">
<GetPaymentTokenResult xmlns:a="http://schemas.datacontract.org/2004/07/Debitsuccess.WebServices.Core.ResponseMessages" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
<DateCreated xmlns="http://schemas.datacontract.org/2004/07/Debitsuccess.WebServices.Core">2020-10-06T11:33:38.9308523+13:00</DateCreated>
<Id xmlns="http://schemas.datacontract.org/2004/07/Debitsuccess.WebServices.Core">531d141f-e515-408c-9530-66428a031ded</Id>
<ResponseNotes xmlns="http://schemas.datacontract.org/2004/07/Debitsuccess.WebServices.Core">
<ResponseMessageNote>
<Code>00</Code>
<Note>Success</Note>
<NoteType>Info</NoteType>
</ResponseMessageNote>
</ResponseNotes>
<Status xmlns="http://schemas.datacontract.org/2004/07/Debitsuccess.WebServices.Core">Succeed</Status>
<a:AccountId>f19536d0-8ec2-44cd-b65c-05159e5e9d23</a:AccountId>
<a:PaymentFormURL>https://oc-qa-sk.debitsuccess.com/PayNow/T/pyRaES9L</a:PaymentFormURL>
<a:Token>pyRaES9L</a:Token>
<a:ValidTo>2020-10-06T11:43:38.9933395+13:00</a:ValidTo>
<a:WebhookToken>kt8IKvt4</a:WebhookToken>
</GetPaymentTokenResult>
</GetPaymentTokenResponse>
</s:Body>
</s:Envelope>Update payment method using AdjustAccountPaymentMethod
The AdjustAccountPaymentMethod can be used to update the customer’s payment method, but please see the note above regarding PCI. Provide the following details:
AccountNo
Bank count number or credit card noAccountHolder
nameonbankaccorcreditcardAccountType
CreditCardType
Required for credit cardExpiryDate
Required for credit card
Sample request message
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:deb="Debitsuccess.WebServices.WCF" xmlns:deb1="http://schemas.datacontract.org/2004/07/Debitsuccess.WebServices.Core">
<soapenv:Header/>
<soapenv:Body>
<deb:AdjustAccountPaymentMethod>
<deb:request>
<deb1:DateCreated>2020-09-22</deb1:DateCreated>
<deb1:Id>333</deb1:Id>
<deb1:RequestInitiator>Kin333</deb1:RequestInitiator>
<deb1:User>
<deb1:Id>33333</deb1:Id>
<deb1:Password>#Password</deb1:Password>
<deb1:Username>username</deb1:Username>
</deb1:User>
<deb1:AccountReferenceNo>DEA2884487</deb1:AccountReferenceNo>
<deb1:ExternalAccountReferenceNo></deb1:ExternalAccountReferenceNo>
<deb1:NewPaymethod>
<deb1:AccountHolder>Test</deb1:AccountHolder>
<deb1:AccountNo>5555555555554444</deb1:AccountNo>
<deb1:AccountType>CreditCard</deb1:AccountType>
<deb1:CreditCardType>Mastercard</deb1:CreditCardType>
<deb1:ExpiryDate>2020-12</deb1:ExpiryDate>
</deb1:NewPaymethod>
</deb:request>
</deb:AdjustAccountPaymentMethod>
</soapenv:Body>
</soapenv:Envelope>Sample response message
Related Articles
-
-
-
-
-
-
GetPaymentToken — Retrieves a token and a URL that 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.
-
AdjustAccountPaymentMethod — Changes the method of payment within the Debitsuccess Billing System by providing either new Bank Account or Credit Card details.
© 2021 Debitsuccess. All rights reserved