B2B Mobile Transaction API - Status Codes

Paydiant's Status Codes communicate the status of a given transaction at any point in the process of its completion. The codes are grouped into two categories, based on whether the status relays information about the transmission or about the payment authorization:

  • Response status codes provide information about the transmission state of a specific call to the Paydiant platform through an exposed endpoint.
  • Payment status codes indicate the current approval state of a request for payment approval that was submitted to the processor for the payment account.

Response status codes

Paydiant's Response Status Codes relay information about the state of the transmission of the call.

Status object format

When any request is submitted to Paydiant through one of its exposed endpoints, the response always includes the status attribute using the following convention:

...
status":{
  "statusCode":"FAILED",
  "statusDescription":"Tender not supported",
  "statusDetails":[
    {
      "statusCode":"370",
      "statusDescription":"Tender not supported",
      "statusType":"PLATFORM"
    }
  ]
},
...
  • Depending on the originating call, the statusDetails message can provide context-specific details instead of the generic messages described here.
  • See Response Status Codes and their endpoints for a list of statusDetail response status codes and the endpoints that use them.
  • The documentation for each individual method includes the specific response status codes used by that endpoint.
  • Payment status codes are listed after the response codes and endpoints table.

Response Status Codes and their endpoints

The following table lists the response status codes and the endpoints that use them. See the individual method descriptions to see the response codes grouped by endpoint.

Code Message Used by
304 Invalid arguments

Detailed description is context-specific, such as PartnerUri cannot be null or empty.
enrollCustomerAndProvisionCard
retrieveMobileTransactionMetadata
updateMobileTransaction
309 Invalid checkout token retrieveMobileTransactionMetadata
337 No transaction details found retrieveMobileTransactionMetadata
updateMobileTransaction
341 Transaction has been canceled retrieveMobileTransactionMetadata
updateMobileTransaction
347 Transaction in use retrieveMobileTransactionMetadata
updateMobileTransaction
360 Operation timeout retrieveMobileTransactionMetadata
updateMobileTransaction
361 Checkout token blocked retrieveMobileTransactionMetadata
370 Tender not supported enrollCustomerAndProvisionCard
updateMobileTransaction
385 Transaction not ready retrieveMobileTransactionMetadata
386 endpoint Error

Detailed description is context-specific.
enrollCustomerAndProvisionCard
retrieveMobileTransactionMetadata
updateMobileTransaction
updateMobileTransaction
cancelTransaction
releaseMobileDeviceCheckoutToken
389 Issuing partner is not configured
to support stub customer records.
enrollCustomerAndProvisionCard
390 Data access error updateMobileTransaction
391 The external entity is not found

Detailed description is context-specific.
retrieveMobileTransactionMetadata
427 Invalid external entity state

Detailed description is context-specific.
Reserved for future use
430 Declined updateMobileTransaction
431 Insufficient funds updateMobileTransaction
443 Processing error occurred updateMobileTransaction
444 Processing error occurred at gateway updateMobileTransaction
445 Transaction cannot be processed updateMobileTransaction
447 Transaction not supported
in the integration
updateMobileTransaction
449 Invalid amount specified updateMobileTransaction
450 Invalid card number specified updateMobileTransaction
451 Invalid expiry date specified updateMobileTransaction
452 Expired credit card updateMobileTransaction
490 Invalid Transaction, Contact Issuer updateMobileTransaction
491 Suspected Fraud, Contact Issuer updateMobileTransaction
523 Payment account enrollment card provisioning
operation declined
enrollCustomerAndProvisionCard
524 Payment account enrollment card provisioning
operation not supported
enrollCustomerAndProvisionCard
525 CRUD not possible enrollCustomerAndProvisionCard

Payment status codes

Paydiant's Payment status codes relay information about the current state of the payment.

Payment status code categories

Payment status codes are grouped into the following general categories:

Code Range Description
200-209 Settlement Status: Information about the terms and execution of payment.
210-219 Authorization Status: Information about verification of all systems involved in the transaction.
220-229 Schedule Status: Information about the current state of processing.
230-239 Refund Status: Information about issuance of a credit.
240-249 Payment Status: Information about the state of the payment system.
250-299 Payment Input Failures: Explanations of payment failure due to input error.
340-344 Non-transaction processing status codes (Database Update Status)
345-369 Non-transaction processing input related failures
370-379 Balance Inquiry related status
380-389 Verification related status
500-549 Issuer related status
550-599 Merchant related status codes
600-619 Full reversal of payment and refund codes
620-639 Payment void and refund transaction status codes

Note: Codes within each range have been reserved for use by the type specified for that range. However, there is not necessarily a status assigned to every code within the range.

Payment Status Codes by category

The specific payment status codes are listed here by the type of failure they represent, such as Refund or Schedule.

Settlement Status

Code Status Message Description
200 Approved Payment Payment for the transaction has been approved.
201 Declined Payment Payment for the transaction has been declined.
202 Settlement Failed The transaction is authorized, but the settlement failed.
203 Insufficient Funds The account from which the payment is being drawn does not have enough money to cover the amount due.

Authorization Status

Code Status Message Description
210 Authorization Approved The payment authorization has been approved.
211 Authorization Failed Approval of the payment authorization has failed.

Schedule Status

Code Status Message Description
220 Approved and Scheduled The payment authorization is approved and has been scheduled for processing.
221 Scheduled The payment is scheduled for processing.

Refund Status

Code Status Message Description
230 Refund Approved The credit transaction is accepted.
231 Refund on Hold The transaction is awaiting settlement and cannot be refunded at this time.
232 Refund Failed The credit transaction is declined.
235 Refund Not Possible The refund is not permitted for this transaction.
236 Refund Data Mismatch The data input for the refund transaction does not match that of the original purchase.
237 Refund Amount Exceeded The refund transaction amount is in excess of the original purchase.

Payment Input Failures

Code Status Message Description
250 Invalid Inputs The transaction contains one or more invalid parameter entries.
251 Invalid Amount The amount entered is not a valid format (for example, multiple decimal points can have been entered).
252 Invalid Card Number The credit card number entered is not valid (e.g., too many or too few digits).
253 Invalid Expiry Date The credit card expiration date is not a valid date.
254 Expired Card The credit card expiration date has already passed.
255 Invalid ABA The ABA code is not valid for the card.
256 Invalid Account Number The account number is invalid.
257 AVS Mismatch The transaction resulted in an AVS mismatch. The address provided does not match billing address of card holder.
258 Invalid Card Code The card code (CVV2/CVC2/CID) is invalid.

Database Update Status

Code Status Message Description
340 Success The CRUD (Create/Read/Update/Delete) operation was successful.
341 CRUD Not Possible The CRUD operation cannot be completed. Please wait five minutes before retrying.

Non-transaction Input Failures

Code Status Message Description
349 Entity is Deleted The referenced entity has been removed and cannot be retrieved.

General Payment Status

Code Status Message Description
240 Duplicate Transaction The transaction has already been submitted.
241 Processing Error An error has occurred during processing. Please wait five minutes before retrying.
242 Gateway Processing Error An error has occurred in transmission. Please wait five minutes before retrying.
243 Transaction Not Allowed This transaction cannot be processed at the customer’s financial institution.
244 Transaction Under Review The transaction is being audited.
350 Entity Does Not Exist The referenced entity does not exist in the system. Recheck the ID or URI used to retrieve.
351 Duplicates Not Allowed The URI provided results in a duplicate record if created. Update the existing record instead.
352 Empty Partner URI A valid partner URI is required.
353 Empty Tenant URI A valid tenant URI is required.
354 Empty Merchant URI A valid Merchant URI is required.
355 Empty User Profile URI A valid user profile URI is required.
356 Empty Currency URI A valid currency URI is required.
357 Empty Financial Institute URI A valid financial institute URI is required.
358 Empty Wallet Account URI A valid wallet account URI is required.
359 Empty Payment Processor URI A valid payment processor URI is required.
360 Invalid Partner URI A valid partner URI is required.
361 Invalid Tenant URI A valid tenant URI is required.
362 Invalid Merchant URI A valid mobile payments URI is required.
363 Invalid User Profile URI A valid user profile URI is required.
364 Invalid Currency URI A valid currency URI is required.
365 Invalid Financial Institute URI A valid financial institute URI is required.
366 Invalid Wallet Account URI A valid wallet account URI is required.
367 Invalid Payment Processor URI A valid payment processor URI is required.
368 Invalid Payment Image Category URI A valid payment image category URI is required.
369 Invalid Payment Image URI A valid payment image URI is required.

Balance Inquiry Status

Code Status Message Description
370 Balance Inquiry Success The account balance was successfully retrieved.
371 Balance Inquiry Failure The account balance could not be retrieved.
372 Balance Unavailable The account balance is temporarily unavailable.
373 Balance Not Supported The account balance could not be retrieved because that action is not supported.
374 Invalid Balance Amount The account balance returned is not a valid amount.
375 Invalid Balance Request The account balance could not be retrieved because the request contained invalid parameters.
Code Status Message Description
380 Verification Success The account has been successfully verified.
381 Verification Failed The account could not be verified due to an unknown error.
382 Verification Amount Mismatch The amount provided does not match the account verification.
383 Verification Period Expired The amount could not be verified because the allowed period has expired.
384 Verification Not Supported The amount could not be verified because the action is not supported.
385 Verification Not Available The amount could not be verified because the action is temporarily unavailable.
386 Invalid Verification Request The amount could not be verified because the request contained invalid parameters.
387 Verification Initiated The double deposit account verification is in progress, but has not completed.
388 Unsupported IIN The Issuer Identification number provided is not in the supported range.
Code Status Message Description
500 Invalid Transaction The transaction request is not valid; contact Issuer.
501 Suspected Fraud A fraudulent transaction is suspected; contact Issuer.
503 Service Fault The Issuer service is temporarily unavailable due to maintenance.
Code Status Message Description
550 Merchant Error The data transmitting from the POS terminal has resulted in an error.

Full Reversal of Payment and Refund Status

Code Status Message Description
600 Full Reversal Success The transaction was successfully reversed and refunded.
601 Full Reversal Denied Reversal of the transaction is not permitted.
602 Full Reversal External System Failure The transaction could not be reversed due to a failure of one or more external systems.
603 Full Reversal System Failure The transaction could not be reversed due to a system failure.
604 Full Reversal Not Possible The transaction could not be reversed, possibly because the reversal is not supported or the transaction has already been reversed.

Voided Payment and Refund Status

Code Status Message Description
620 Void Success The transaction was successfully voided and refunded.
621 Void Denied Voiding the transaction is not permitted.
622 Void External System Failure The transaction could not be voided due to a failure of one or more external systems.
623 Void System Failure The transaction could not be voided due to a system failure.
624 Void Not Possible The transaction could not be voided, possibly because the transaction has already been voided or cannot be located.

Next

Feedback