Credit funds to a user account

1

Finish your internal validations

Ensure that your internal validations are completed. Confirm the receipt of funds to the wallet if the transfer relies on external dependencies.

2

Prepare the payload

To facilitate compliance and tracking, prepare the required payload to tag all transactions and identify the source of funds.

Additional transaction metadata

• details.pp - Payment processor, which identifies which type of payment was processed or executed
• details.transaction_comments - Any message or internal comments on the transaction
• details.payment_ref - The payment reference identifier generated by the payment service provider
• details.source_account - The fund source account or card number for the debit or credit
• details.source_bank_name - The fund source bank name or the bank issuer of the card (when available)
• details.source_network_name - The name of the network where the transaction is processed, e.g., Mastercard, VISA, etc. (when available)

3

Credit funds to the user account from the prefund

Call the Create Credit or Transfer Transaction (POST /users/wallets/funds) to add funds to the user account. This action will utilise the funds from the program prefund account balance and add it to the program account balance.

You can use any of these user identifiers (user_id, mobile, email) to identify the destination of the transfer. In this example, we will use the user_id of the owner of the destination account.

Create Credit or Transfer Transaction request (recipient: user account)

 
curl --location 'https://{{accounts_base_url}}/{{product_code}}/v1/users/wallets/funds' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--header 'Authorization: ••••••' \
--data-urlencode 'user_id={{user_id}}' \
--data-urlencode 'amount=50' \
--data-urlencode 'details={
    \"pp\":\"<SEE_ANTI_SCAM_MEASURES_DOC>\",
    \"transaction_comments\":\"<SEE_ANTI_SCAM_MEASURES_DOC>\",
    \"payment_ref\":\"<SEE_ANTI_SCAM_MEASURES_DOC>\",
    \"source_account\":\"<SEE_ANTI_SCAM_MEASURES_DOC>\",
    \"source_bank_name\":\"<SEE_ANTI_SCAM_MEASURES_DOC>\",
    \"source_network_name\":\"<SEE_ANTI_SCAM_MEASURES_DOC>\"
}'

Reference: Anti-scam Measures

Create Credit or Transfer Transaction response (recipient: user account)

 
{
    "id": "edde2e3c44428660970d11e0b53888b9c3de744c82a3568c70c6f5c8c0023e98",
    "ref_id": "000002C1000000000003000000000278",
    "user_id": "cb532825ef5397a0571b3b66f20780d7",
    "wallet_id": "4cc5efa24dc483f578dcccc17ac6b459",
    "confirm": "skip",
    "sor_transaction": null,
    "category_details": [
        {
            "name": "DEFAULT",
            "amount": "50.00",
            "currency": "USD"
        }
    ]
}

4

Handle errors gracefully

As a financial payment platform, we subject every transaction to a series of checks and validations to ensure adherence to the limits configured for the account. Any resulting failures or errors are communicated via the response payload structure shown below. A comprehensive list of error codes for this API is available on the API reference page.

Sample error response

 
{
"id":"683e98350c1e8",
"code":400,
"status":"user_parameter_validation_failed",
"title":"User Parameter Validation Failed",
"description":"Field required not met; amount must be greater than 0",
"link":"https://developer.matchmove.com/docs/optimus-prime/docs/Overview/4.%20Handle%20Errors/b.-Error-List.md#user_parameter_validation_failed",
"timestamp":"2025-06-03 14:06:41 +08"
}

5

Display / notify transaction status to end user

Closed-loop transactions, like account crediting, do not have any webhook events associated with them. Since these types of transactions are synchronous, the response and status will be received immediately after API execution.

For partners who intend to send a push notification via in-app, email, or SMS — the API response payload containing transaction details and other metadata can be used in message content. To learn more about closed-loop transaction notifications, head to the Anti-Scam Measures section.