Create a user wallet virtual account
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
Destination bank account number for reversals. Required only when the program requires a reversal destination.
Bank account holder name. Required only when the program requires a reversal destination.
Bank code of the destination bank. Required only when the program requires a reversal destination.
Response
Virtual account created successfully.
Response Attributes
Virtual account unique identifier.
Banking provider's account identifier.
Virtual account number.
Name of the account holder.
Bank account number.
Bank code.
Virtual account status.
Timestamp when the virtual account was created/assigned.
Name of the bank.
Address of the bank.
Bank country (ISO 3166-1 alpha-2).
Reversal destination account. Present only when the program requires a reversal destination.
Bad Request
The response code field indicates which specific rule was violated.
Possible error codes:
resource_user_wallet_not_found- User wallet not found or does not existresource_sgprefund_bank_account_detail_incomplete- Incomplete bank account details (Require bank_account_number, bank_holder_name and bank_code)resource_bank_code_invalid- Invalid bank code parameter
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:
access_denied- Access is denied for this resource
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