---
title: "[Sandbox] Update status of mock bank transfer payment"
method: PUT
path: "/sandbox/customer_profile/{customer_profile_id}/payments/{contract_id}"
---

# \[Sandbox\] Update status of mock bank transfer payment

`PUT /sandbox/customer_profile/{customer_profile_id}/payments/{contract_id}`

## Request

- Base URL: `https://api-sandbox.straitsx.com/v1`
- URL: `https://api-sandbox.straitsx.com/v1/sandbox/customer_profile/{customer_profile_id}/payments/{contract_id}`
- Auth: API key in header `X-XFERS-APP-API-KEY`

[Available in Sandbox environment only] Update status of mock bank transfer payment to completed or failed

## Path parameters

- `customer_profile_id` string, required
- `contract_id` string, required

## Headers

- `X-XFERS-APP-API-KEY` string, required
- `X-PUBLIC-KEY-ID` string
- `X-TIMESTAMP` string
- `X-NONCE` string
- `X-SIGNATURE` string

## Request body

- object
  - `data` object
    - `attributes` object
      - `status` string, required: Accepts only `completed` or `refunded`, `pending`

## Response `200`

200

- object
  - `data` object
    - `id` string: Payment contract ID.
    - `type` string: Transaction type.
    - `attributes` object
      - `idempotencyId` string: Idempotency key for the transaction.
      - `customerProfileId` string: Associated customer profile ID.
      - `amount` string: Transaction amount.
      - `fees` string: Fees charged for the transaction.
      - `status` string: Transaction status.
      - `createdAt` string: Timestamp when the transaction was created.
      - `senderInformation` object: Sender's information.
        - `accountHolderName` string: Sender's bank account holder name.
        - `accountNumber` string: Sender's bank account number.
        - `bankName` string: Sender's bank name.
        - `endToEndRef` string: End-to-end transaction reference.
        - `swiftBic` string: Sender's bank SWIFT/BIC code.
        - `transactionRemarks` unknown
      - `paymentMethod` object: Payment method details.
        - `id` string: Payment method ID.
        - `referenceId` string: Reference ID.
        - `accountNo` string: Recipient's virtual bank account number.
        - `bankShortCode` string: Recipient's bank short code.
        - `recipientName` string: Recipient name.
      - `blockedReasons` object[]: Reasons blocking the transaction, if any.

## Changes

- **2026-11-03** `d17239d67150`: 2 warning, 5 info
  - removed the optional property `data/attributes/paymentMethod/base64EncodedImage` from the response with the `200` status
  - removed the optional property `data/attributes/paymentMethod/virtualPaymentAddress` from the response with the `200` status
  - api operation id `sandbox-update-status-of-mock-paynow-payment` removed and replaced with `update-status-of-mock-bank-transfer-payment`
  - added the optional property `data/attributes/paymentMethod/accountNo` to the response with the `200` status
  - …3 more

[Operation history](https://skmtc.dev/straitsx/apis/straitsx-sandbox-base-url/changes/sandbox/customer_profile/:customer_profile_id/payments/:contract_id/put.md)

---

[API](https://skmtc.dev/straitsx/apis/straitsx-sandbox-base-url.md) - [All operations](https://skmtc.dev/straitsx/apis/straitsx-sandbox-base-url/llms.txt) - [OpenAPI document](https://skmtc.dev/straitsx/apis/straitsx-sandbox-base-url/revisions/d17239d67150?raw)