Error Codes and Descriptions

In case of errors during operations via services, the system returns specific error codes. Here are the response and explanations of the error codes returned by the Paywall payment API:

Example response template returned by Paywall payment API:

Payment API Error Codes

Error Code Number	Error Code
-1	Payment not found
0	Success
1	Failure
2	Unexpected parameters
3	Unsupported payment provider
4	MerchantUniqueCode already exists
5	No suitable provider found for payment
6	Environment / Address configuration not found
7	The payment has already been completed.
8	Unexpected currency.
9	Unexpected installment.
10	Unexpected MerchantUniqueCode.
11	Unexpected MerchantSuccessBackUrl
12	Unexpected MerchantFailBackUrl
13	Unexpected cardholder
14	Unexpected card number
15	Unexpected card expiration date (Month)
16	Unexpected card expiration date (Year)
17	Unexpected payment detail
18	Unexpected card detail
19	The card has expired
20	Payment provider credentials are not configured
21	Stored card identifier (UniqueCode) is invalid
22	No stored card found
23	The stored card is inactive
24	The payment provider is not connected
25	The product list cannot be empty
26	The total amount of products must equal the transaction amount
27	In marketplace model accounts, MemberId cannot be empty
28	The product list contains invalid MemberId
29	Marketplace - Unexpected request
30	Marketplace - No products found to confirm
31	Marketplace - No payment found to confirm
32	Marketplace - Payment not found
33	Marketplace - No products found to report
34	Marketplace - No progress payment found
35	Marketplace - Progress payment has already been sent
36	The product list contains an invalid discount holder (DiscountOwnerType)
37	The product list contains an invalid discount type (DiscountType)
38	The product list contains an invalid discount percentage
39	The product list contains an invalid discount amount
40	The product list contains an invalid shipping type
41	The product list contains an invalid shipping currency
42	The product list contains an invalid shipping amount
43	No debt found
44	The amount must be greater than zero
45	The amount must be greater than zero
46	Unexpected ClientIp data
47	The merchant cannot be found
48	PayWatch payment status is invalid
49	PayWatch payment status ID is invalid
50	PayWatch action ID is invalid
51	PayWatch minute parameter is invalid
52	PayWatch webhook parameter is invalid
53	Unexpected basket shipping type
54	Unexpected basket shipping value
55	Unexpected basket discount type
56	Unexpected basket discount value
57	The calculated progress payment value cannot exceed the payment amount
58	Marketplace - Confirmation request contains invalid product
00	Payment error - General

Physical API Error Codes

Error Code Number	Error Code
System.ServerError	A error occurred due to PayWall
System.ValidationError	Validation error (e.g., sent parameter)
System.AuthError	Authorization error
Connection.NotFound	Connection not found
Connection.NotEqualConnection	Connection is inactive
Connection.UpdatedRecordNotFound	Record to be updated not found
Connection.DeletedRecordNotFound	Record to be deleted not found
Connection.AlreadyExists	Connection already exists
Connection.AlreadyConnected	Connection already exists
Connection.ServiceParametersInvalid	Connection service parameters are invalid
Connection.NotConnected	Connection is not connected
Connection.IsAsyncPaymentNotActive	Connection does not support AsyncPayment or the feature is not enabled
Transaction.NotFound	Transaction not found
Transaction.FailedToGetTransactionList	Transaction list could not be retrieved
Terminal.NotFound	Terminal not found
Terminal.FailedToGetTerminalList	Terminal list could not be retrieved
Terminal.Tag.NotFound	Terminal label not found
Terminal.Tag.AlreadyExistsWithThisCode	Terminal label already exists with this code
Terminal.Tag.DeletedRecordNotFound	Record to be deleted not found
Terminal.Pair.NotFound	Terminal connection not found
Pair.Async.AbsentBodyParam	There is a missing parameter in the request
Pair.Async.AuthenticationFailed	Authorization error
Pair.Async.RequestFailed	Request failed
Pair.Async.RequestNotFound	Request not found
Pair.Async.AlreadyPaired	There is already a connection request
Pair.Async.ConfirmFailed	Approval failed
Pair.Async.ConfirmNotCompleted	Device approval has not been granted yet
Payment.Async.CloudNotSendToDevice	Payment could not be sent to the device
Payment.Async.CloudNotSendToDevice	Payment request not found
Payment.Async.CloudNotSendToDevice	Payment response not found
Payment.Async.NotConvenientStatusForThisOperation	Payment status is not applicable for the related operation
Payment.Async.AlreadyHasRefundOrCancel	Payment has already been refunded/canceled
Payment.Async.MerchantUniqueCodeAlreadyExists	Merchant tracking number already exists
Payment.Request.RequestNotFound	Request not found

General Error Codes

Error Code Number	Error Code
-1	SystemMessage
0	Success
1	Unsuccessful
2	Invalid data
3	No data
4	Header missing
5	Exception
6	Invalid mail
7	Invalid phone
8	ThereIs no such parent
9	Invalid password
10	Invalid two factor type
11	Two factor already exists
12	Merchant not found
13	Already exists payment providerInfo
14	Payment gateway provider not found
15	Invalid base64
16	Logo upload error
17	Invalid merchan credential type
18	Merchant already exists
19	Payment provider credential param not found
20	Payment provider already activated
21	Unexpected payment provider credential param
22	Absent payment provider credential param
23	Invalid ıdentity number
24	Invalid ıdentity tax address
25	Empty manager name
26	Empty manager lastname
27	Empty manager phone
28	Invalid manager phone
29	Empty manager email
30	Invalid manager email
31	Empty manager ıdentity
32	Empty manager birthday
33	Empty merchant address
34	Invalid company type
35	Payment gateway not connected
36	Invalid email
37	Cannot pay again
38	User password locked
39	User expired password
40	Otp error
41	Returned otp code
42	User not found
43	User deleted
44	User deactivated
45	User already exists
46	User could not add
47	Merchant user could not add
48	User password could not add
49	Integration credential could not add
50	Invalid card number
51	Amount
52	Invalid ınstallment
53	Invalid currency
54	Password similarity
55	Credential param already exist
56	Payment not found
57	Payment activity not found
58	EmptyInvoice email
59	InvalidInvoice email
60	Empty website
61	Invalid website
62	Identity already exists
63	Disposable password
64	Integration credential not found
65	Invalid end of day
66	Payment gateway not found
67	Payment gateway not support on us
68	Invalid ıdentity tax number
69	Document type not found
70	Document upload error
71	Invalid successful commission
72	Invalid refund commission
73	Invalid cancellation commission
74	Paywall commission not found
75	Invoice not found
76	Invoice status not found
77	Invalid ınvoice status to pay
78	Invoice already exists
79	Earning not found
80	Invoice could not generate
81	Invoice status could not add
82	Invoice detail could not add
83	Invalid manager ıdentity
84	Invoice cannot generate for future
85	Invalid pgp environment type
86	Payment gateway provider environment not found
87	Payment gateway provider environment already exists
88	Payment gateway provider endpoint already exist
89	Payment gateway provider end point not found
90	Integration credential already exists
91	Integration credential already exists
92	Payment not convenient for operation
93	Payment has successful refund
94	Payment has successful cancel
95	Payment gateway not support operation
96	Payment gateway provider error code already exists
97	Payment already finalized
98	Payment gateway provider currency already exists
99	Unexpected currency
100	Unexpected ınstallment
101	Unexpected merchant unique code
102	Unexpected success back url
103	Unexpected fail back url
104	Unexpected card owner
105	Unexpected card number
106	Unexpected card expired
107	Unexpected card expire month
108	Unexpected card expire year
109	Unexpected payment detail
110	Unexpected card
111	Payment error
112	Payment amount not convenient
113	Date range must be less than 31 days
114	Invalid payment tag
115	Card not found ın card wall
116	Card not available ın card wall
117	Card of card wall exception
118	Card unique code Invalid of card wall
119	Merchant unique code aıready exist
120	E wallet gateway provider not found
121	Invalid ewgp environment type
122	E wallet gateway provider environment already exists
123	E wallet gateway provider environment not found
124	E wallet gateway provider end point already exist
125	E wallet gateway provider currency already exists
126	Already exists Ewallet provider ınfo
127	Link qr upload photo error
128	Photo ıs required sales product
129	Payment link not found
130	Payment link no any changes
131	Invalid sales ıd
132	Payment link ıd
133	Payment link needs agreement approve
134	Payment link quantity required
135	Payment link quantity cannot more stock
136	Payment link expired
137	Payment link error
138	Photo ıs too large
139	Payment checkout not found
140	Payment checkout expired
141	Payment checkout unique code empty
142	Payment checkout ınvalid amount
143	Payment checkout could not generate
144	Payment checkout ıd
145	Payment checkout needs agreement approve
146	Payment checkout must be Threed
157	Payment checkout error
148	Payment checkout exists unique code
149	Payment checkout ıs paid
150	Payment checkout success back url
151	Payment checkout fail back url
152	Payment checkout product limit
153	Payment checkout receiver ınfo empty
154	Payment checkout receiver first name empty
155	Payment checkout receiver last name empty
156	Payment checkout receiver phone empty
157	Payment checkout receiver email empty
158	Payment checkout receiver address ınfo empty
159	Payment checkout receiver province empty
160	Payment checkout receiver district empty
161	Payment checkout receiver address empty
162	Payment checkout receiver note empty
163	Callback address must be filled
164	Callback address limit
165	Callback address ıd empty
166	Invalid callback address
167	Callback address not found
168	Callback address no any changes
169	PayJump delay ms must be less
170	PayJump retry count must be less
171	Document limit reach
172	Pay balancer name empty
173	Pay balancer ınvalid currency
174	Pay balancer ınvalid period type
175	Pay balancer empty flow
176	Pay balancer ınvalid flow pool type
177	Pay balancer ınvalid amount
178	Pay balancer limit reached
179	Pay balancer ınvalid payment gateway
180	Pay balancer unsuccess add main
181	Pay balancer unsuccess add flow
182	Pay balancer unsuccess ın save
183	Pay balancer not found
184	Pay balancer flow not found
185	Pay balancer flow element reached to limit
186	Pay balancer Already ın use
187	Pay balancer already not ın use
188	Pay balancer flow contains duplicate sort
189	Pay balancer flow contains not connected gateway
190	Pay balancer flow save unsuccessful
191	Pay balancer flow no any changes
192	Pay balancer flow contains wrongId
193	Pay balancer flow contains wrong payment gateway
194	Pay balancer no any changes
195	Invalid payroute type
196	Payroute paybalancer must has all currencies
197	Payroute connected to paybalancer
198	Member not found
199	Member API not supported way
200	Member type ın valid
201	Member external ıd required
202	Member name required
203	Member title required
204	Member tax office required
205	Member tax number required
206	Member ıdentity number required
207	Member email required
208	Member phone required
209	Member address required
210	Member contact name required
211	Member contact last name required
212	Member Input length ın correct
213	Member tax number ınvalid
214	Member ıdentity ınvalid
215	Member mail ınvalid
216	Member phone ınvalid
217	Member bank account contains ınvalid currency
218	Member bank account contains empty title
219	Member bank account contains empty ıban
220	Member bank account title too long
221	Member bank account ıban too long
222	Member bank account ınvalid ıban
223	Member ıd or external ıd must be filled
224	Member ınvalid operation
225	Member no any changes
226	Member bank account contains multiple currency
227	Member already exist
228	Member ıd required
229	Member bank account exist for currency
230	Member bank account ıd required
231	Member bank account not found
232	Member bank account no any changes
233	Member value date calculation type ınvalid
234	Member value date calculation value ınvalid
235	Member value date commission ınvalid
236	Member value date not found
237	Market place settings not found
238	Market place ınvalid type
239	Market place changes not found
240	Market place not support this type yet
241	Payout provider not found
242	Payout provider credential param not found
243	Unexpected payout provider credential param
244	Absent payout provider credential param
245	Payout provider end point not found
246	Payout connection not found
247	Payout provider currency ınvalid
248	Payout provider end point ınvalid
249	Payout communication not found
250	Payout activity not found
251	Payout transaction not found
252	Market place needs main payout
253	Merchant bank account contains ınvalid currency
254	Merchant bank account contains empty title
255	Merchant bank account contains empty ıban
256	Merchant bank account title too long
257	Merchant bank account ıban too long
258	Merchant bank account ınvalid ıban
259	Merchant bank account exist for currency
260	Merchant bank account ıd required
261	Merchant bank account not found
262	Merchant bank account no any changes
263	Market place uses this payout provider
264	Market place debt not found
265	Market place debt not available to pay
266	Member not found to send debt
267	Member bank account not found to send debt
268	Payout connection currency ın correct
269	This operation cannot do ın this time
270	Card production not found
271	Card production credential param not found
272	Unexpected card production credential param
273	Absent card production credential param
274	Card production end point not found
275	Card production connection not found
276	Card production currency ınvalid
277	Card production end point ınvalid
278	Card production card not found
279	Card status not available for this
280	Card not have externalInfo
281	Apm provider not found
282	Apm provider credential param not found
283	Unexpected apm provider credential param
284	Absent apm provider credential param
285	Apm provider end point not found
286	Apm connection not found
287	Apm provider currency ınvalid
288	Apm provider end point ınvalid
289	Apm transaction could not generated
290	Apm merchant unique code too long
291	Apm success back url too long
292	Apm fail back url too long
293	Apm communication not found
294	Apm activity not found
295	Apm activity not available for payment
296	Apm transaction not found
297	Card production Insufficient funds
298	Card production ınvalid phone number
299	Card production merchant account not active
300	Card production merchant not authorized for this operation
301	Card production defined brand not found
302	Card production category not found
303	Payment product already approved
304	Market place cannot user recurring
305	Subscription type ınvalid
306	Subscription period type ınvalid
307	Subscription ınvalid trial day
308	Subscription fail attempt ınvalid
309	Subscription fail attempt pending hour ınvalid
310	Subscription ıtems empty
311	Subscription ıtems contains ınvalid type
312	Subscription ıtems missing name
313	Subscription ıtems contains too long name
314	Subscription amount not equalItems
315	Subscription customer object ınvalid
316	Subscription customer name too long
317	Subscription customer lastname too long
318	Subscription customer phone ınvalid
319	Subscription customer phone too long
320	Subscription customer email ınvalid
321	Subscription customer email too long
322	Subscription already exists
323	Subscription not found
324	Subscription ıtem not found
325	Subscription already passive
326	Subscription already active
327	Subscription does not has card
328	Subscription card expired
329	Subscription last ıtem cannot delete
330	Subscription amount ınvalid
331	Card production external Id too long
332	Card production phone too long
333	Card production description too long
334	Invalid environment type
335	Environment not found
336	Environment already exists
337	Endpoint already exist
338	Endpoint not found
339	Currency already exists
340	Payment gateway provider error code not found
341	Subscription ıtem pool not found
342	Subscription ıtems contains ınvalid pool ıd
343	Subscription customer not found ın pool
344	Subscription customercCould not ınsert to pool
345	Subscription customer name must filled
346	Subscription customer lastname must filled
347	Subscription customer pool not found
348	Subscription customer pool ın use
349	Subscription last card cannot delete
350	Subscription card limit reached
351	No any changes
352	Subscription period count ınvalid
353	Payment has earning operation refused
354	No permission and data ın request
355	Request exists wrong permission group
356	Request exists wrong permission
357	Permission association not found
358	Permission association already exists
359	Apm transaction status not convenient for this operation
360	Apm transaction has refund activity
361	Reflection date cannot weekend
362	Market place earning changes refused
363	Reflection date ınvalid
364	Reflection date ınvalid after 16 same day
365	Earning amount ınvalid
366	Market place earning already ın payment queue
367	Market place earning already ın retry
368	Market place earning already success
369	Market place earning no any unsuccessful
370	Market place ınvalid process time
371	Special key not found
372	Special key already exists
373	Apm partial refund amount more than transaction amount
374	Apm sector not found
375	Apm provider default sector not found
376	Apm provider sector not found
377	Apm provider sector already exists
378	Payment provider credential param already exists
379	Payout credential param already exists
380	Apm credential param already exists
381	Card production credential param already exists
382	Invalid report type
383	Invalid file password
384	Invalid receiver
385	Invalid receiver cannot be more3
386	Invalid start date
387	Invalid end date
388	Active async report wait till done
389	Async report request not found
390	Async report request no file password
391	Paywatch min ınvalid
392	Already exist data
393	External ıd must be filled
394	External ıd must be less ten char
395	Async report request not support storage file
396	Async report request must has a feature
397	Partner not found
398	Partner permission not found
399	Partner relation a ıready exists
400	Bad request
401	Unauthorized
403	Forbidden
404	Not found
500	Internal exception
501	Not ımplemented
502	Bad request network
503	Service unavailable
504	Gateway timeout
505	Partner relation not found
506	Partner relation permission not found
507	Partner relation cannot be same merchant
508	Rsa encryption already exists
509	Rsa encryption public key ınvalid
510	Rsa encryption not found
511	Rsa encryption has delete protection
512	Card wall ıp reached
513	Invalid ıp
514	Card wall ıpa ıready exists
515	Card wall ıp not found
516	Card wall ıp has change protectio
517	Async report request not by admin
518	Invalid ınvoice fix fee
519	No ınvoice fix fee
520	Invoice settings not found
521	Invoice settings config ınvalid
522	Invoice settings ıs ınvalid
523	PayWall product ıs not ınvoice scope
524	Merchant commission already exists
525	Merchant commission not found
526	Merchant commission tier already exists
527	Merchant commission tier not found
528	Merchant commission tier detail already exists
529	Merchant commission tier detail not found
530	PayWall product not found
531	Route table exists
532	Route table not found
533	Route table ın use
534	PayRoute connected to route table
535	Route table detail already exists
536	Route table detail to cannot contains all and single
537	Route table detail not found
538	Route table must has all currencies
539	Route table limit reached
540	Invalid focused feature
541	VPos rule not configured
542	VPos rule
543	VPos rule locked
544	Balance not enough
545	Market place cost type ınvalid
546	Market place ınvalid standard cost
547	Market place ınvalid maximum cost
548	Market place maximum cost apply cannot true
549	Market place cost reduction type ınvalid
550	Market place manual trigger limit
551	Market place manual trigger cannot active for this config
552	Invalid configuration
553	Date range cannot be today
554	Paybalancer ınvalid distribution type
555	Region not found
556	Payment production not found
557	Payment card not found
558	Payment customer not found

Payment Error JSON

{
    "ErrorCode": 0,
    "Result": true,
    "Message": "",
    "Body": ""
}