Errors

Error response

A refused call returns a JSON body with these fields:

Field Meaning
status_code 1 on failure.
status_error_code PayMe's numeric error code.
status_error_details The error message.
status_additional_info More detail, such as the field or value that failed. On HTTP 422, every validation message, joined with spaces.
session PayMe session ID. Quote it when you contact PayMe support.
{
  "status_code": 1,
  "status_error_details": "The contract amount is over the maximum amount for the selected payment method",
  "status_additional_info": "Max amount 5000000",
  "status_error_code": 393,
  "session": "FhT3aXe7"
}

Check status_code, not only the HTTP status

The fields are the same as in Payments API error responses: see Payments Errors.

Contract error codes

The contract endpoints return these codes in status_error_code:

Code Message When
380 Payment contract not found No contract with this guid involves your seller account
381 Not enough details for unique recipient identification Only recipient.business_code was sent and it matches no PayMe seller. Add email or phone
382 Cannot perform action due to payment contract status inconsistency The action isn't allowed in the contract's current status
383 Initiator and recipient are the same The recipient is the initiator's own account
384 Recipient account settings problem - please contact Customer Support The recipient's seller account is inactive
385 Action not allowed - please contact Customer Support Your seller account isn't a side of this contract, or didn't upload this file
386 Uploading multiple files not allowed - please contact Customer Support Two files of the same type, or an unknown type, in one upload
387 Uploading multiple files with same name not allowed Two files with the same name in one upload
388 File type has to be the same A replacement file has a different type
389 The payment method isn't attached to the payer's account, please attach it or use a different one The payer has no attached card or direct-debit authorization
390 The credit card expiration date is lower than the payment's due date, please add another payment method No attached card is valid on payment.due_date
391 We didn't find any bank debits we can use for that account, please create a new one or select a different payment method No direct-debit authorization is Active
392 The selected payment method isn't matching the provided token buyer_key isn't one of the payer's attached payment methods
393 The contract amount is over the maximum amount for the selected payment method A credit-card or il-direct-debit contract over 5000000
394 The selected payment method does not match the provided token buyer_key sent with funds-transfer

Each endpoint page lists every code it returns, for example Create a payment contract and Transfer funds between sellers. A contract that fails after it was created carries its own error_code (11000 to 11004): see B2B payment contracts.