Update a Receive Account

Receive accounts of a transaction can only be updated if no transactions have been forwarded for delivery in that particular receive account. Hence, there should be no transactions to a receive account or active transactions should have Delivery Status as NONE and in some cases, DELIVERY HOLD.

PATCH /users/{{user_id}}/receive-users/{{receive_user_id}}/accounts/{{receive_user_account_id}}

Details

Bank

Fields	Updatable
account_number	Yes
account_type	Yes
bank_id	Yes
branch_location	Yes
branch_id	Yes
swift_bic_code	Yes
rtn_number	Yes

Wallet

Fields	Updatable
msisdn	Yes
wallet_type	No
payer_id	Yes

Request Sample

Bank

curl --location -g --request PATCH '{{url}}/users/{{user_id}}/receive-users/{{receive_user_id}}/accounts/{{receive_user_account_id}}' \
--header 'X-Client-Id: {{client_id}}' \
--header 'X-Client-Secret: {{client_secret}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "account_number": "0037275350",
     "payout_method": "BANK_DEPOSIT",
    "account_type": "CHECKING",
    "bank_id": 4,
    "branch_id": 45,
    "branch_location": 1,
    "rtn_number": "4342492422",
    "swift_bic_code": "OCCICOBCBO8"
}'

Wallet

curl --location -g --request PATCH '{{url}}/users/{{user_id}}/receive-users/{{receive_user_id}}/accounts/{{receive_user_account_id}}' \
--header 'X-Client-Id: {{client_id}}' \
--header 'X-Client-Secret: {{client_secret}}' \
--header 'Content-Type: application/json' \
--data-raw '{
        "msisdn": "237653801972",
        "wallet_type": "TELS",
        "payer_id": 42,
        "payout_method": "WALLET"
    }'

Response Sample

Bank

{
    "account_number": "0037275350",
    "account_type": "CHECKING",
    "bank_id": 4,
    "branch_id": 45,
    "branch_location": "1",
    "created_at": "2022-09-30T04:48:28.26789",
    "id": "f29e44f7-633d-46cc-bbe2-6197e193eae1",
    "payout_method": "BANK_DEPOSIT",
    "status": "UNVERIFIED",
    "swift_bic_code": "OCCICOBCBO8",
    "user_id": "51a13748-2684-4ee3-a630-46f2fabf694f"
}

Wallet

{
    "created_at": "2022-09-30T04:56:52.396836",
    "id": "20e09eb7-d9e4-4aaa-b17b-e1d899b208c0",
    "msisdn": "237653801972",
    "payout_method": "WALLET",
    "status": "VERIFIED",
    "user_id": "cfafc7b6-7756-45e7-8bb1-9f2f0df4554a",
    "wallet_type": "TEL"
}