---
title: "Tạo hoặc cập nhật hồ sơ trang thanh toán"
method: PUT
path: "/api/v1/payment-profile"
tags: ["Hosted checkout"]
---

# Tạo hoặc cập nhật hồ sơ trang thanh toán

`PUT /api/v1/payment-profile`

## Request

- Base URL: `https://api.monapay.vn`
- URL: `https://api.monapay.vn/api/v1/payment-profile`
- Auth: HTTP bearer and API key in header `X-Client-Secret`

Kiểm tra tài khoản ngân hàng và VA thuộc client. return_signature_secret chỉ được trả một lần khi tạo mới.

## Request body

- PaymentProfile: Hồ sơ nhận diện và tài khoản mặc định cho hosted checkout. return_signature_secret chỉ được trả một lần khi tạo hoặc xoay.
  - `display_name` string, required
  - `logo_url` string, uri, nullable: Logo HTTPS, tối đa 512 KB.
  - `hotline` string, nullable
  - `support_email` string, email, nullable
  - `default_bank_account_id` string, uuid, required
  - `default_virtual_account_id` string, uuid, nullable
  - `va_prefix` string, required
  - `owner_number` string, required
  - `owner_type` 'PER' | 'ORG', required
  - `merchant_id` string, required
  - `terminal_id` string, required
  - `beneficiary_name` string, required
  - `accent_color` string, nullable
  - `locale` 'vi' | 'en', required
  - `show_mona_badge` boolean, required
  - `return_signature_secret` string: Secret 48 ký tự, chỉ có trong response tạo mới hoặc xoay secret.

## Response `200`

Hồ sơ đã lưu.

- object
  - `success` boolean, required
  - `message` string, required
  - `data` PaymentProfile, required: Hồ sơ nhận diện và tài khoản mặc định cho hosted checkout. return_signature_secret chỉ được trả một lần khi tạo hoặc xoay.
    - `display_name` string, required
    - `logo_url` string, uri, nullable: Logo HTTPS, tối đa 512 KB.
    - `hotline` string, nullable
    - `support_email` string, email, nullable
    - `default_bank_account_id` string, uuid, required
    - `default_virtual_account_id` string, uuid, nullable
    - `va_prefix` string, required
    - `owner_number` string, required
    - `owner_type` 'PER' | 'ORG', required
    - `merchant_id` string, required
    - `terminal_id` string, required
    - `beneficiary_name` string, required
    - `accent_color` string, nullable
    - `locale` 'vi' | 'en', required
    - `show_mona_badge` boolean, required
    - `return_signature_secret` string: Secret 48 ký tự, chỉ có trong response tạo mới hoặc xoay secret.

## Other responses

- `422`: VA hoặc dữ liệu hồ sơ không hợp lệ.

---

[API](https://skmtc.dev/monapay/apis/mona-pay-api-v1.md) · [All operations](https://skmtc.dev/monapay/apis/mona-pay-api-v1/llms.txt) · [OpenAPI document](https://skmtc.dev/monapay/apis/mona-pay-api-v1/revisions/ed3fbd821dce?raw)