Something Went Wrong Were Sorry. Please Start Over and Try Again. Masterpass
1. Introduction
As shortly equally you start working with our platform, sooner or later information technology happens: You become stuck. You receive cryptic mistake messages and our platform rejects your transaction requests.
But fear non: Nosotros have the tools that volition help you. We have designed our platform to give you the greatest autonomy in your daily online transaction business organization, even when confronted with errors.
Have a look at our b est p ractices , our troubleshooting tools and explanations of the about common error letters. They volition help you profoundly to prevent and solve transaction problem!
ii. Follow Best Practices
The best way to tackle down errors is – of course – to avoid them in the first place. Although this is not possible in all cases, nosotros accept created a listing of best practices. Following them will help become live faster by d odg ing the most common obstacles :
- Ever u se our Exam environs first before going live or adding a new feature to your live shop. Both our Test surround / nav.aside.title.get-started.alive-environs treat transaction request in the same fashion. As the expected behaviour and error messages are the same, it is an ideal way to test for any imponderables or stage scenarios
- Read the defended guide for the respective production carefully. Brand sure to know the correct endpoint URL and all accepted parameters. Start sending requests with the absolute minimum of mandatory parameters to lear n the basics of the respective product . This is especially helpful when dealing with alternative payment methods that require a lot of parameters.
- Cheque that the payment method you want to use is activated in your Dorsum Role ( Configuration > Payment Methods ) and targeted in your request with parameters PM/Brand
- Confirm that the option yous want to use is activated in your Back Office ( Configuration > Account > Your options )
- Be aware that we offer different ways to integrate with our platform . All of them require an individual arroyo
- Use the shopping cart p lugins we natively back up . As they come up from certified providers, they have been thoroughly tested to create requests correctly
- Understand the significant of transaction condition codes and the transaction error codes . They aid you find the crusade of failed requests .
- Distinguish failed requests from unsuccessful payments
-
- A failed asking is the result of an unsuccessful pre-payment check past our platform . In virtually cases, impacted transaction s do not take a ny status at all . They oftentimes appear in our secure payment folio with a generic fault bulletin . These are invalid requests containing technical errors that forbid our platform to process the transaction altogether. Our system adds them to our Back Office error logs with more than detailed information. Take a look at the well-nigh typical ones and how to treat them.
The prototype show s a typical generic error message on our secure payment page.
An unsuccessful payment is a transaction with either status 0/1/2 . T his is the outcome of a technically valid request, albeit rejected past a third party (past the acquirer or issuer) . To learn about the rejection reason, look upwards the transaction in the Dorsum Role ( Operations > View transactions ) . T he acquirer ticket and the 8-digit mistake message in the transaction overview contains more information .
The images show due south the acquirer ticket and the 8-digit fault message in the transaction overview
However, failures similar these can still be caused by an error on our platform in specific situations . Brand sure to contact us if your transaction reject rate is to a higher place boilerplate.
- Let costless traffic between your server and our platform by following our Firewall documentation.
Apart from our best practices, we offer y'all diverse diagnostic tools . In many cases, they will help you get to the root cause and ameliorate the fault completely on your ain!
- Every error analysis requires you to understand during which pace exactly the error occurs. Have a look at this determination tree to learn where yous need to fix your transaction flow :
shows the different scenarios of erroneous transaction s and how to deal with them
If our platform rejects a transaction , we create a log entry in the Dorsum Office of the PSPID the transaction was sent to. Get to Configuration > Error logs to check them. The table provides valuable information to understand what went wrong and what you can exercise to set up the error
Column | Description |
---|---|
Date time | Timestamp of the request |
Way | Integration way trigram . Possible values : STD : Hosted Payment Page DPR : DirectLink AFU: Batch (advanced) THP: FlexCheckout |
Requestor'due south IP address | The IP the request was sent from |
PAYID | Unique reference of the transaction in our system. Is only created if the mandatory parameters are sent correctly |
Description | Detailed clarification of the error. Check our list for the nigh common error letters |
The image shows the table displaying the logs of a failed transaction attempt
- We offer pages in our Back Office you can use to simulate different integration modes . Go to Support > Integration and user manuals > Test pages . Choose one of the available modes past clicking on ". asp " in the respective line. In the subsequent screen, fill in the outset fix of parameters (which are the mandatory parameters for each integration). C lick then on " Submit " to send the asking .
- We constantly monitor our platform to react speedily for any unforeseen events that may touch on your online business – something you tin can do, too! Enrol with our s tatus page to be always up to engagement for outages and planned maintenance. This will aid you distinguish problems on our platform from errors on your finish.
The prototype show s the Ingenico condition page displaying a notification nearly a service interruption for one our acquirers.
4. Sympathize fault messages
An important role of alteration errors is to know exactly what they mean. We have collected the virtually common ones with some detailed explanation. All these error message s appear either in the
- Customers' browser during the payment process
- Back Office ( Configuration > Error logs )
- XML response you receive for DirectLink / FlexCheckout requests
Find more errors and how to bargain with them in our Transaction error codes overview .
All described errors prevent our platform from processing the request birthday.
-
Why exercise I get this?
The value yous send along with the transaction for parameter SHASIGN does not match with what we expected.
For which integration modes can this happen?- Hosted Payment Page
- DirectLink
What can I practice to solve this?
Make sure to summate SHASIGN as explained in our documentation.
-
Why do I go this?
You lot do non send the mandatory parameter SHASIGN in your transaction asking.
For which integration modes tin this happen?- Hosted Payment Page
- DirectLink
What tin can I do to solve this?
Make sure to send SHASIGN with your transaction request as explained in our documentation.
-
Why do I get this?
- Our platform does not recognise the referrer you lot have configured in Configuration > Technical information > Data and origin verification > Checks for e-Commerce & Allonym Gateway > URL of the merchant folio containing the payment course that will telephone call the page: orderstandard.asp
For which integration modes can this happen?
- Hosted Payment Page
What can I do to solve this?
- Enter the correct value for the deferrer in the Back Part . The deferrer is the URL sending requests to classic.urltestorderstandard_utf8.asp / archetype.urlprodorderstandard_utf8.asp
- As this is not an obligatory check, 50 eave the field empty . Our platform will not perform this cheque altogether
-
Why practise I become this ?
- Our platform does non receive the referrer you lot have configured in Configuration > Technical information > Data and origin verification > Checks for east-Commerce & Allonym Gateway > URL of the merchant folio containing the payment form that will call the page: orderstandard.asp .
For which integration modes tin this happen?
- Hosted Payment Page
What tin I exercise to solve this?
- Make sure that your organisation does not block the transfer of t he referrer information when making transaction requests to our platform . In some cases, your customers' browser block s the transfer as well. In a scenario like this, w e will skip this check if the SHASIGN value is correct
- Enter the right value for the deferrer in the Back Office . The deferrer is the URL sending requests to classic.urltestorderstandard_utf8.asp / archetype.urlprodorderstandard_utf8.asp
- As this is non an obligatory check, leave the field empty. Our platform will not perform this check birthday
-
Why do I get this ?
- Our platform does non recognise the IP address you lot have configured in Configuration > Technical information > Data and origin verification > Checks for DirectLink and Batch (Automatic) > When using these transaction submission modes, login details accept to be transmitted in the HTTP parameters .
For which integration modes tin this happen?
- DirectLink
- Worldline Batch (avant-garde)
What can I do to solve this?
- Enter the correct IP accost(es) in the Dorsum Part from which requests are sent to our endpoints for DirectLink / Worldline Batch (advanced)
- As this is not an obligatory check, leave the field empty. Our platform will not perform this check altogether
-
Why do I go this ?
- This is a generic error message for data validation errors . Information technology volition appear in i of the following scenarios
- You lot transport incorrect data in parameters USERID / PSWD
- Your transaction asking is missing 1 or more mandatory parameters
- P arameters sent to our platform contain no values or invalid values
For which integration modes can this happen?
- DirectLink
- Worldline Batch (advanced)
What tin can I exercise to solve this?
- Configure your API user and API password in both your system and in the Back Part
- Make sure to transport all mandatory parameters correctly as described in our documentation for the respective integration way .
-
Why practise I go this ?
- The value you lot transport along with the transaction for parameter SHASIGNATURE.SHASIGN does not match with what we expected.
For which integration modes can this happen?
- Flexcheckout
What tin can I do to solve this?
- Make sure to calculate SHASIGNATURE.SHASIGN as explained in our documentation .
-
Why exercise I get this ?
- 1 of the mandatory Flexcheckout parameters is missing in your transaction request. "< parameter >" acts as a placeholder for this error message. If you do not send Business relationship.PSPID , the error message will exist " 55555555 – Account . PSPID missing or incorrect format "
For which integration modes tin can this happen?
- Flexcheckout
What can I practise to solve this?
- Make certain to send all mandatory parameters correctly as described in our documentation
-
Why practise I become this ?
- The proper name of the account y'all send in parameter PSPID does not exist or is not active however.
For which integration modes tin can this happen?
- Hosted Payment Folio
- Flexcheckout
- DirectLink
- Worldline Batch (avant-garde)
What can I practice to solve this?
- Bank check the name of your account and that is sent correctly in parameter PSPID
- Mind that we have both a Examination environment / Alive environment . The proper noun of your accounts may differ per environment
- Check your business relationship's activation condition in the Back Office via Home > Informative steps . Contact united states of america if you need help identifying / activating your PSPID
-
Why do I get this ?
- One of the mandatory parameters is missing in your transaction request. "< parameter >" acts equally a placeholder for this error message. If you practice not transport PSPID , the error message volition be " no PSPID "
For which integration modes can this happen?
- Hosted Payment Page
- Flexcheckout
- DirectLink
- Worldline Batch (advanced)
What tin can I practice to solve this?
- Check the documentation of th e respective integration mode for the mandatory parameters .
-
Why do I get this ?
- The value sent for a specific parameter exceeds the maximum length. "< parameter >" acts as a placeholder for this error message. If PSPID is impacted , the error bulletin will be " no PSPID "
For which integration modes can this happen?
- Hosted Payment Page
- Flexcheckout
- DirectLink
- Worldline Batch (advanced)
What can I do to solve this?
- Look up the parameter in our Parameter Cookbook . Ascertain the value as described in columns "Format" / "Max length"
-
Why practise I get this ?
- The value sent for parameter AMOUNT exceeds the maximum length and / or contains invalid characters.
For which integration modes can this happen?
- Hosted Payment Page
- DirectLink
- Worldline Batch (advanced)
What can I do to solve this?
- Look upwardly parameter Corporeality in our Parameter Cookbook . Define the value as described in columns "Format" / "Max length" .
-
Why do I get this ?
- The value sent for parameter CURRENCY has not been added to your PSPID.
For which integration modes can this happen?
- Hosted Payment Folio
- DirectLink
- Worldline Batch (avant-garde)
What tin I do to solve this?
Log on to the Back Part and become to Configuration > Account > Currency . Select the missing currency from the driblet down carte du jour and click on " Add "
-
Why do I get this ?
- The payment method y'all desire to target with parameter PM and / or Brand has not been added / activated in your PSPID.
For which integration modes tin this happen?
- Hosted Payment Folio
- Flexcheckout
- DirectLink
- Worldline Batch (avant-garde)
What can I do to solve this?
- Log on to the Back Office and go to Configuration > Payment methods . Check whether the payment method is " Agile " in column " Condition " .
- In our Test surround , you lot can activate any inactive payment method on your own past accessing the payment method via the dark-green pen symbol > PM activation. You can also add together any new payment method via Configuration > Payment methods > Choose new payment method
C o ntact us to add together / actuate payment methods in our Live environs .
-
Why do I get this ?
- You have tried to capture an corporeality that is bigger than the originally authorised amount .
For which integration modes can this happen?
- DirectLink maintenance
- Worldline Batch (advanced) maintenance
What can I do to solve this?
- Before you send your capture request, make certain to transport for parameter Corporeality simply what has been originally authorised.
- If a transaction has been partially captured before, send for parameter AMOUNT only the remaining amount to be captured
- You have tried to capture an corporeality that is bigger than the originally authorised amount .
5. Transaction error codes
You can find more data on transaction errors and statuses here.
If y'all log on to your Worldline account, yous'll find all possible errors and statuses in the User guides section of the Back up carte.
FAQs
Why tin't I refund my payment?
There are different reasons why you lot can't refund a transaction. Y'all need to consider the post-obit (with the condition that the Refund option is enabled in your account):
- The transaction is in an "incomplete" status, such as a pending or erroneous status (91, 92 etc.) that doesn't allow the refund operation.
- If the transaction is authorised (condition 5), at which point no payment has been made however. In this case you accept to cancel the authorisation instead of refund.
- The used payment method doesn't support the refund functionality, which can be the instance with certain debit cards, web banking methods and "offline" payment methods such as Depository financial institution transfer.
What does the message "An error has occurred; please try once again later. If y'all are the possessor..." mean?
The message "An error has occurred; please endeavor again later. If y'all are the owner or the integrator of this website, please log into the Worldline back office to run across the details of the error." is a generic mistake message which is returned if a specific technical event occurs at the moment the payment folio is called. We don't display the actual fault on the payment folio, mainly because of security reasons, merely also not to confuse your customers.
In your Worldline account, via "Configuration" > "Error logs", yous can easily await up the errors that occurred when the generic error message was displayed. The actual meaning of these errors are described on the Possible errors page.
What should I practice if affiliation number is not working anymore?
Sometimes it happens that an affiliation number has been put inactive on the side of the acquirer. We advise you contact your acquirer for this.
Source: https://epayments-support.ingenico.com/help/troubleshooting
Belum ada Komentar untuk "Something Went Wrong Were Sorry. Please Start Over and Try Again. Masterpass"
Posting Komentar