Add funds to user wallet
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 load. Numeric and greater than zero. Required unless rule is supplied.
Currency of the amount. Optional; defaults to the program's default currency.
Receiver's email. One of the receiver-identifying fields.
Receiver's mobile country code (digits, max length 4). Must be supplied together with mobile.
Receiver's mobile number (digits, length 5-14). Must be supplied together with mobile_country_code.
Receiver's user hash id (alphanumeric, max length 32). One of the receiver-identifying fields.
Receiver card hash id (alphanumeric, max length 32). One of the receiver-identifying fields.
Hashed PAN of the receiver card (max length 64). One of the receiver-identifying fields.
Proxy number of the receiver card (max length 16). One of the receiver-identifying fields.
When true, funds are loaded directly onto the identified card and receiver-contact criteria are not required. Optional.
trueFree-text transaction details (max length 512). Optional.
Originating actor reference (alphanumeric, max length 32). Optional.
Fund category to allocate the load to. Optional.
When true, the load can be 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 and amount
is computed from the rule. Optional.
Reference id used to initialise a money-transfer receiver flow. Optional.
Response
Funds added to wallet successfully.
Response Attributes
Transfer identifier.
Show child attributes
Show child attributes
Optional message attached to the transfer.
Transfer status.
Transfer amount.
Transfer currency (ISO 4217).
Fees applied to the transfer.
Show child attributes
Show child attributes
Whether confirmation is required (confirm_required) or skipped (confirm_skip).
Confirmation links. Present when confirmation is required.
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:
resource_card_fund_transfer_id_required- Transferidis requiredresource_card_fund_transfer_record_not_found- Transaction 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
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