Reverse a wallet fund transaction
Header Parameters
The matchmove issued user_id for which the request is being made
The IP using which the actor is making the request
The unique id of the device using which the actor is making the request
The user agent of the device using which the actor is making the request
The actor on behalf of whom the API request is being performed
Path Parameters
Unique identifier for your program, issued by MatchMove during onboarding. All requests must use the program_code assigned to your integration. Using a program_code that does not belong to your integration will result in an authorization error.
Body Parameters
Amount to reverse/refund. Numeric and greater than zero. Must not exceed the original transaction amount; a smaller value performs a partial refund. Required for partial refunds and when using category allocation/split.
When true, the reversal is split across categories using rule. Optional.
truefalseWhen true, the deducting category allocation is used. Cannot be combined with allow_split_category_transaction=true. Optional.
truefalseJSON-encoded array of category allocation rules (each with an amount).
When supplied, allow_split_category_transaction must be true. Optional.
Response
Wallet fund transaction reversed successfully.
Response Attributes
User identifier.
Wallet identifier.
Reversal or refund result, keyed by type (reversal for full, refund for partial).
Show child attributes
System-of-record transaction reference. Null when not configured.
Bad Request
The response code field indicates which specific rule was violated.
Possible error codes:
invalid_partial_refund_amount- Amount should be lesser than the original transaction amountinvalid_partial_refund_amount_less- Amount should be lesser than the remaining partial amountuser_not_found- User not found or does not exist
Response Attributes
Unique hash-id for the error message
Error response status code
Error response code
Error response title
Error response detail
Source defines the multiple error messages
Show child attributes
Response timestamp
Unauthorized Request
The response code field indicates which specific rule was violated.
Possible error codes:
invalid_token- Access denied due to invalid token on header
Response Attributes
Unique hash-id for the error message
Error response status code
Error response code
Error response title
Error response detail
Source defines the multiple error messages
Show child attributes
Response timestamp
Forbidden
The response code field indicates which specific rule was violated.
Possible error codes:
resource_user_lockout- User currently has a pending transaction
Response Attributes
Unique hash-id for the error message
Error response status code
Error response code
Error response title
Error response detail
Source defines the multiple error messages
Show child attributes
Response timestamp
Not Found
The response code field indicates which specific rule was violated.
Possible error codes:
resource_not_found- Resource not found
Response Attributes
Unique hash-id for the error message
Error response status code
Error response code
Error response title
Error response detail
Source defines the multiple error messages
Show child attributes
Response timestamp
Method Not Allowed
The response code field indicates which specific rule was violated.
Possible error codes:
method_not_allowed- The HTTP method is not allowed here
Response Attributes
Unique hash-id for the error message
Error response status code
Error response code
Error response title
Error response detail
Source defines the multiple error messages
Show child attributes
Response timestamp
Internal Server Error
The response code field indicates which specific rule was violated.
Possible error codes:
internal_error- An internal gateway error occurred
Response Attributes
Unique hash-id for the error message
Error response status code
Error response code
Error response title
Error response detail
Source defines the multiple error messages
Show child attributes
Response timestamp
Not Implemented
The response code field indicates which specific rule was violated.
Possible error codes:
not_implemented- This operation is not implemented
Response Attributes
Unique hash-id for the error message
Error response status code
Error response code
Error response title
Error response detail
Source defines the multiple error messages
Show child attributes
Response timestamp
Bad Gateway
The response code field indicates which specific rule was violated.
Possible error codes:
bad_gateway- Bad gateway error.
Response Attributes
Unique hash-id for the error message
Error response status code
Error response code
Error response title
Error response detail
Source defines the multiple error messages
Show child attributes
Response timestamp
Service Unavailable
The response code field indicates which specific rule was violated.
Possible error codes:
service_unavailable- Service is temporarily unavailable
Response Attributes
Unique hash-id for the error message
Error response status code
Error response code
Error response title
Error response detail
Source defines the multiple error messages
Show child attributes
Response timestamp
Gateway Timeout
The response code field indicates which specific rule was violated.
Possible error codes:
gateway_timeout- Gateway timeout error.
Response Attributes
Unique hash-id for the error message
Error response status code
Error response code
Error response title
Error response detail
Source defines the multiple error messages
Show child attributes
Response timestamp