post https://api.helloasso.com/v5/payments//refund
Votre token doit avoir l'un de ces rôles :
OrganizationAdmin
FormAdmin
Si vous êtes une association, vous pouvez obtenir ces rôles avec votre client.
Si vous êtes un partenaire, vous pouvez obtenir ces rôles par le flux d'autorisation.
Votre clientId doit être autorisé à tous ces privilèges :
RefundManagement
Remboursement partiel (BETA)
Effectuer un remboursement partiel sur une commande entraîne une incohérence dans le back-office de l'association. Bien que le solde du portefeuille (wallet) reste correct, la commande apparaîtra comme "payée" même si elle n'a pas été totalement remboursée.
Erreurs de remboursement
Lors qu'un remboursement échoue, une erreur HTTP 409
, 400
vous est renvoyé avec un message erreur dans le body.
Format
{
"errors": [
{
"code": "Error",
"message": "Code : [CODE_ERREUR] - [MESSAGE_ERREUR]"
}
]
}
Type d'erreur
Code | Message |
---|---|
101 | The payment specified is not found, payment id : '{0}' |
102 | The source wallet is not found. |
103 | The target wallet is not found. |
104 | The specified operation is not found. |
105 | The specified operation is already reconcile. |
106 | There are multiple matched transactions for the specified operation. |
107 | The amount between the specified operation and the partner transaction doesn't match. |
108 | The specified operation state is processed but the partner transaction is not authorized. |
109 | Reconcile request time out. |
110 | Reconcile request error not managed. |
111 | The payment method type is not implemented. |
112 | One operation with the same type is currently processing. |
113 | The transfer operation cannot be processed, the payment is not authorized. |
115 | One transfer operation is processed. |
116 | Cannot process the p2p. |
117 | Cannot process the p2p. |
118 | There are multiple matched transactions for the p2p operation. |
119 | Operation bad state. |
120 | The amount between p2p operation and p2p does not match. |
121 | The source wallet for transfer operation does not match. |
122 | The target wallet for transfer operation does not match. |
123 | The refund operation is not found. |
124 | Refund operation bad state. |
125 | Cannot update the refund operation. |
126 | There are no p2p operation to retake. |
127 | The source wallet id are not matched between transfer operation and payment. |
128 | The target wallet id are not matched between transfer operation and payment. |
129 | Cannot process the p2p, error not managed. |
130 | The transfer request timed out. |
131 | The transfer operation state not match the partner transaction state. |
132 | One operation with the same type is already processed. |
133 | The payment is not authorized, cannot process a transfer operation. |
134 | Refund operation bad type. |
135 | Cannot update the payment(s). |
136 | Payment bad cashout_state. |
137 | Cash-in operation not found. |
138 | There are no tip operation to retake. |
139 | The cash-in operation is not reconcile. |
140 | The refund payment operation is not found. |
141 | Payment bad state. |
142 | Order bad state. |
143 | Cannot update the action(s). |
144 | Operation not reconcile. |
145 | Payment not reconcile. |
146 | Cannot refund this order the refund operation do no specified to cancel the order. |
147 | Refund operation bad type. |
148 | Cannot refund this operation, the payment doesn't have a tip. |
149 | Payment not reconcile. |
150 | Tip already refund. |
151 | Action bad status |
152 | Transaction not found. |
153 | One refund operation is currently processing. |
154 | The payment doesn't have a provider. |
155 | There are no tip operation to reput. |
156 | Refund error managed. Engaging reput. |
157 | The provider type is not supported. |
158 | Payment Request Data not found. |
159 | Payment Operation not updated. |
160 | The order specified is not found. |
161 | The organization wallet is not found. |
162 | The payment operation tip is not found. |
163 | The payment operation is not found. |
164 | The payment operation cash-in is not found. |
165 | The amount to refund is not allowed. |
166 | The amount tip to refund is not allowed. |
167 | The card is not allowed to refund (expired). |
168 | The payment date is not allowed to refund (too old). |
169 | Cannot create the refund operation, there are an existing refund operation refused. |
170 | Action tip not existing for a tip amount to refund. |
171 | The payment state is not authorized to refund. |
172 | The payment provider is not allowed. |
173 | The payment has a bad state. |
174 | The payer wallet is not found. |
176 | The cashout id {0} is not found. |
177 | The cashout is not in a progress state, cashout id : {0}. |
178 | The cashout operation is not found of cashout id : {0}. |
179 | Error to create cashout for organization id : {0}. |
180 | Error to create operation cashout for cashout id : {0}. |
181 | The amount must be corresponding to the amount of this order. |
182 | The amount tip must be corresponding to the amount tip of this order. |
183 | Payment card cannot be created. |
184 | Organization is excluded from cash out, organization Id : {0}. |
185 | Organization is not authenticated, wallet Id: {0}. |
186 | The cash-out amount cannot be inferior to 1€, wallet Id: {0}. |
187 | The provider with type {0} is not found. |
188 | No wallet found for organization, data : {0}. |
189 | The organization doesn't have an administrator, organization Id : {0}. |
190 | The admin is not found, admin Id : {0}. |
191 | Can't create a wallet because the names are invalids, organization Id : {0}. |
192 | Can't create a wallet because the kyc or admin email is empty, organization Id : {0}. |
193 | Payment is not authorized for this organization, organization Id : {0}. |
194 | Email is not authorized, email : {0}. |
195 | The payment request data is not in INIT state, {0}. |
196 | An error occurred when we tried to do the tip p2p. |
197 | Error on Reverted CashOut. |
198 | Transaction Ref is null or empty. |
199 | The {0} state is not authorized". |
200 | Payment is not on Refused status. |
201 | The payment with {0} is not eligible for this operation. |
202 | The wallet identifier is missing. |
203 | The form type is not specified. |
204 | The payment card with id {0} is not found. |
205 | The payment card identifier not found. |
206 | Payment amount not match with payment amount or tip amount. |
207 | Operation not managed. |
208 | Payer is not found. |
209 | Fiscal Receipt Option is not found. |
210 | The payment is cashed out, it is not authorized to refund |
211 | The amount to refund is less than the minimum amount allowed to refund. |
212 | The form type '{0}' is not valid in this context. |
213 | The action with id '{0}' has not payer linked. |
214 | The payer doesn't have an user identifier. |
215 | The action payment not updated with action id {0} and the payment id {1}. |
216 | Payer not updated. |
217 | There is no tip on this order. |
218 | The order tip is already canceled. |
219 | There is one or more payments that do not belong to the order |
220 | The payment list contains all future payments of the order |
221 | One of payment tips already canceled |
222 | One of payments already canceled |
223 | The organization does not have enough balance to cover the refund |
224 | The limitation date is missing |
225 | The refund operation payment is not found |
226 | The checkout datamodel for id '{0}' is unexpectedly empty |
227 | Refund not allowed |
228 | The provider with the id '{0}' is not found. |
229 | The provider is not found. |
230 | The organization '{0}' have no provider with balance. |
231 | Regularization of this payment is not allowed. |
232 | Maximum number of cash-in attempts reached. |
233 | Regularization payment operation is not found. |
234 | This feature is disabled |
235 | The payment is disputed. |
236 | The reference : {0} of this payment : {1} is not found. |
237 | User is not authorized to execute this payment : payment id : {0}, connected user id : {1}, payment user id : {2} |
238 | The dispute (externalRef : {0}) of this payment {1} is not found. |
239 | The tip amount must be greater or equal to 0 to initialize the cash out. |
240 | No payment eligible for this cash out. |
241 | Organization not eligible for cashout |
242 | There is a difference between the initial amount and the current Cashout amount : initial amount : {0}, current amount : {1}. |
243 | A cash out is initilizing. Creating a new one would lead to uncertain results. |
244 | A cash out is initilizing. Creating a refund would lead to uncertain results. |
245 | Pending cashout operation not found for an unknown reason. Create a new one to avoid blocking the revert process. |
246 | CashOut execution max attempts reached. |
247 | Unknown CashOut error or cashout has already been fully processed on provider. Please verify the cashout, payments, and payment operations. The provider state is : '{0}'. |
249 | Direct transfer of fund between Helloasso and a contributor is not allowed. |
250 | Direct transfer of fund between organization and a contributor is not allowed. |
251 | Organization Iban is not found, organization id : {0}, provider id : {1}. |
252 | Unsupported payment method type. |