---
updatedAt: 2026-04-27T06:52:10.000Z
agentTools:
  projectIndex: https://docs.straitsx.com/llms.txt
---

# [Sandbox] Update status of mock PayNow payment

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

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "sandbox-2",
    "version": "1.7.0"
  },
  "servers": [
    {
      "url": "https://api-sandbox.straitsx.com/v1"
    }
  ],
  "components": {
    "securitySchemes": {
      "sec0": {
        "type": "apiKey",
        "in": "header",
        "name": "X-XFERS-APP-API-KEY"
      }
    }
  },
  "security": [
    {
      "sec0": []
    }
  ],
  "paths": {
    "/sandbox/payments/{contract_id}": {
      "put": {
        "summary": "[Sandbox] Update status of mock PayNow payment",
        "description": "[Available in Sandbox environment only] Update status of mock PayNow payment to completed or failed",
        "operationId": "update-sandbox-regular-payment-mock-paynow-status",
        "responses": {
          "200": {
            "description": "",
            "content": {
              "application/json": {
                "examples": {
                  "OK": {
                    "summary": "OK",
                    "value": {
                      "data": {
                        "id": "contract_3b90b46511d54ac2b9e7e49344d68263",
                        "type": "paynowTransaction",
                        "attributes": {
                          "idempotencyId": "268fd78a-b874-47dc-a22c-8baa63238ed9",
                          "amount": "0.1",
                          "fees": "0.0",
                          "status": "completed",
                          "createdAt": "2024-06-25T09:48:34.081+08:00",
                          "senderInformation": {
                            "accountHolderName": "John Doe",
                            "accountNumber": "123456789",
                            "bankName": "DBS Bank Ltd",
                            "endToEndRef": "Testing Remarks",
                            "swiftBic": "DBSSSGSGXXX",
                            "transactionRemarks": null
                          },
                          "paymentMethod": {
                            "id": "paynow_75c8335d-0e91-4110-ba85-7af9298c7094",
                            "referenceId": "new_persistent_QR_2",
                            "virtualPaymentAddress": "UEN#FAZZ",
                            "base64EncodedImage": "iVBORw0KGgoAAAANSUhEUgAAASwAAAEsEAYAAAAp7VI2AAAABGdBTUEAALGPC/"
                          },
                          "blockedReasons": []
                        }
                      }
                    }
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string",
                          "example": "contract_3b90b46511d54ac2b9e7e49344d68263",
                          "description": "PayNow contract ID."
                        },
                        "type": {
                          "type": "string",
                          "example": "paynowTransaction",
                          "description": "Request type."
                        },
                        "attributes": {
                          "type": "object",
                          "properties": {
                            "idempotencyId": {
                              "type": "string",
                              "example": "268fd78a-b874-47dc-a22c-8baa63238ed9",
                              "description": "Idempotency ID for the transaction."
                            },
                            "amount": {
                              "type": "string",
                              "example": "0.1",
                              "description": "Transaction amount."
                            },
                            "fees": {
                              "type": "string",
                              "example": "0.0",
                              "description": "Additional transaction fees charged."
                            },
                            "status": {
                              "type": "string",
                              "example": "completed",
                              "description": "Transaction status."
                            },
                            "createdAt": {
                              "type": "string",
                              "example": "2024-06-25T09:48:34.081+08:00",
                              "description": "Timestamp when the transaction was created."
                            },
                            "senderInformation": {
                              "type": "object",
                              "properties": {
                                "accountHolderName": {
                                  "type": "string",
                                  "example": "John Doe",
                                  "description": "Sender's bank account holder name."
                                },
                                "accountNumber": {
                                  "type": "string",
                                  "example": "123456789",
                                  "description": "Sender's bank account number."
                                },
                                "bankName": {
                                  "type": "string",
                                  "example": "DBS Bank Ltd",
                                  "description": "Sender's bank name."
                                },
                                "endToEndRef": {
                                  "type": "string",
                                  "example": "Testing Remarks",
                                  "description": "End user's added comments/notes."
                                },
                                "swiftBic": {
                                  "type": "string",
                                  "example": "DBSSSGSGXXX",
                                  "description": "Sender's bank SWIFT/BIC code."
                                },
                                "transactionRemarks": {
                                  "description": "Transaction remarks."
                                }
                              },
                              "description": "Sender information."
                            },
                            "paymentMethod": {
                              "type": "object",
                              "properties": {
                                "id": {
                                  "type": "string",
                                  "example": "paynow_75c8335d-0e91-4110-ba85-7af9298c7094",
                                  "description": "PayNow payment method ID."
                                },
                                "referenceId": {
                                  "type": "string",
                                  "example": "new_persistent_QR_2",
                                  "description": "Reference ID."
                                },
                                "virtualPaymentAddress": {
                                  "type": "string",
                                  "example": "UEN#FAZZ",
                                  "description": "PayNow virtual payment address."
                                },
                                "base64EncodedImage": {
                                  "type": "string",
                                  "example": "iVBORw0KGgoAAAANSUhEUgAAASwAAAEsEAYAAAAp7VI2AAAABGdBTUEAALGPC/",
                                  "description": "Base64-encoded PayNow QR image for the PayNow payment method."
                                }
                              },
                              "description": "Payment method details."
                            },
                            "blockedReasons": {
                              "type": "array",
                              "items": {
                                "type": "object",
                                "properties": {}
                              },
                              "description": "Reason blocking the transaction, if any."
                            }
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        },
        "parameters": [
          {
            "in": "path",
            "name": "contract_id",
            "schema": {
              "type": "string"
            },
            "required": true,
            "description": "Contract ID is retrieved from the response of Create a mock PayNow payment API"
          },
          {
            "name": "X-XFERS-APP-API-KEY",
            "in": "header",
            "description": "You can retrieve this from your Dashboard Developer Tools.<br><br><strong>Note:</strong> The `X-XFERS-APP-API-KEY` is a mandatory header for all authentication methods, including standard API key usage and HTTP Request Signing mode.",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "X-PUBLIC-KEY-ID",
            "in": "header",
            "description": "The Key ID, can be retrieved from your StraitsX Dashboard.<br><br><strong>Note:</strong> This header attribute is required when HTTP Request Signing is enabled for your account.",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "X-TIMESTAMP",
            "in": "header",
            "description": "Current Unix epoch time in seconds. Must be within ±300 seconds of server time.<br><br><strong>Note:</strong> This header attribute is required when HTTP Request Signing is enabled for your account.",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "X-NONCE",
            "in": "header",
            "description": "A unique UUID string per request, used for replay protection. Must not be reused within the timestamp window.<br>Regex: `/\\A[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}\\z/i`<br><br><strong>Note:</strong> This header attribute is required when HTTP Request Signing is enabled for your account.",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "X-SIGNATURE",
            "in": "header",
            "description": "Base64-encoded digital signature of the canonical request string.<br><br><strong>Note:</strong> This header attribute is required when HTTP Request Signing is enabled for your account.",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "data": {
                    "type": "object",
                    "properties": {
                      "attributes": {
                        "type": "object",
                        "properties": {
                          "status": {
                            "type": "string",
                            "description": "Accepts only `completed` or `failed`"
                          }
                        },
                        "required": [
                          "status"
                        ]
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    }
  },
  "x-readme": {
    "headers": [],
    "explorer-enabled": true,
    "proxy-enabled": true
  },
  "x-readme-fauxas": true
}
```