Create a 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
Hash id of an existing unclaimed transaction (PP_Consumer) to link to the newly created wallet. Optional. When supplied it must reference an active, unclaimed transaction belonging to the authenticated user.
Response
Wallet created successfully.
Response Attributes
Unique reference for the wallet in the MatchMove system.
Account identification number for the wallet.
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Reason for the current status, if any.
Wallet proxy number.
Additional rules, limits and configuration on the wallet (config defaults merged with the user's transactional ledger limits). Limit keys follow the <transaction_type>_limits convention.
Show child attributes
Cards linked to this wallet. Present only when the user has cards.
Show child attributes
Bad Request
The response code field indicates which specific rule was violated.
Possible error codes:
user_parameter_validation_failed- Field required not met; Create wallet is currently disableduser_parameter_validation_failed- Field required not met; User [first_name / last_name / preferred_name] is missinguser_parameter_validation_failed- Field required not met; User has an existing walletuser_not_found- User not found or does not existuser_wallet_creation_in_progress- User wallet creation in progress
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:
risk_management_engine_error- An exception occurred during the processing of the risk and compliance of the user.user_blocked_risk_threshold_exceeded- User has exceeded the risk and compliance threshold and was automatically blocked.
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:
resource_ycs_exception_error_no_20- Card processor error. Unable to process your request.resource_user_wallet_funds_processor_cannot_be_reached- Processor cannot be reachederror_code_9002a- Server was not able to process your request.
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