Create payin request | Manis Technology

curl -X POST https://https//https/api/v1/payins \
     -H "x-secret: {{FINMO_MERCHANT_SECRET}}" \
     -H "Content-Type: application/json"

{
  "payCode": {
    "bankInfo": {
      "bankName": "string",
      "bankAddress": "string",
      "bankCountry": "string",
      "accountNumber": "string"
    },
    "routingInfo": [
      {
        "routingCode": "SWIFT Code",
        "routingValue": "CITISGSG"
      }
    ]
  },
  "createdAt": "2025-10-03T07:03:43.097Z",
  "createdBy": "merch-01k0rc69p8a5m6k5c9h1d3rf90",
  "updatedAt": "2025-10-03T07:03:44.935Z",
  "updatedBy": "merch-01k0rc69p8a5m6k5c9h1d3rf90",
  "pspPayinId": "PR005512",
  "transaction": {
    "pspId": "nium",
    "amount": 2,
    "currency": "SGD",
    "createdAt": "2025-10-03T07:03:43.093Z",
    "createdBy": "merch-01k0rc69p8a5m6k5c9h1d3rf90",
    "requestId": "8a9a4c28-b973-4fb2-8915-15f06b7d4e40",
    "updatedAt": "2025-10-03T07:03:44.929Z",
    "updatedBy": "merch-01k0rc69p8a5m6k5c9h1d3rf90",
    "customerId": "cus-01k0s6n7ad06fcqpwb7qrgxn02",
    "merchantId": "merch-01k0rc69p8a5m6k5c9h1d3rf90",
    "webhookUrl": "https://sandbox.manisconnect.net/api/v1/merchant/merch-01k0rc69p8a5m6k5c9h1d3rf90/webhook/3",
    "paymentType": "VIRTUAL_ACCOUNT",
    "pspTransactionId": "string",
    "manisTransactionId": "txn-01k6me4f7nvv65h0zhjp90tmjg",
    "manisTransactionStatus": "EXCEPTION"
  },
  "pspPayinMethod": "GLOBAL",
  "manisTransactionId": "txn-01k6me4f7nvv65h0zhjp90tmjg"
}

This API initiates a new PayIn transaction through a specified Payment Service Provider (PSP). It supports various pay-in types such as Direct Payin or Virtual Account.

Request Body:

Field	Type	Required	Description
`requestId`	string	Yes	A unique request ID specified by the client in the request.
`pspId`	string	No	Identifier of the Payment Service Provider (e.g., `nium`, `finmo`). If not provided, auto psp selection will choose the best suited psp based on routing rule
`amount`	number	Yes	Amount to be received via PayIn.
`currency`	string	Yes	Currency of the transaction (e.g., SGD).
`country`	string	Yes	Country code (ISO 3166-1 alpha-2) where the transaction originates (e.g., SG).
`paymentType`	string	Yes	Type of PayIn transaction. Supported values: `QR_PAYMENT,` `VIRTUAL_ACCOUNT`.
`manisPaymentMethodName`	string	Yes	Name of the Manis payment method (different with psp’s payinMethodName), will be used to search for payinMethod
`paymentFlow`	string	Yes	Name of the Manis payment flow, will be used to search for payinMethod
`virtualAcountId`	string	Required when creating payin with type `VIRTUAL_ACCOUNT` on Finmo	Identifier of virtual account
customerId	string	Required when creating payin with type `VIRTUAL_ACCOUNT` on Nium	Unique identifier in Manis of the customer making the PayIn.

This API initiates a new **PayIn** transaction through a specified Payment Service Provider (PSP). It supports various pay-in types such as **Direct Payin** or **Virtual Account**. **Request Body:** | Field | Type | Required | Description | | --- | --- | --- | --- | | `requestId` | string | Yes | A unique request ID specified by the client in the request. | | `pspId` | string | No | Identifier of the Payment Service Provider (e.g., `nium`, `finmo`). If not provided, auto psp selection will choose the best suited psp based on routing rule | | `amount` | number | Yes | Amount to be received via PayIn. | | `currency` | string | Yes | Currency of the transaction (e.g., SGD). | | `country` | string | Yes | Country code (ISO 3166-1 alpha-2) where the transaction originates (e.g., SG). | | `paymentType` | string | Yes | Type of PayIn transaction. Supported values: `QR_PAYMENT,` `VIRTUAL_ACCOUNT`. | | `manisPaymentMethodName` | string | Yes | Name of the Manis payment method (different with psp's payinMethodName), will be used to search for payinMethod | | `paymentFlow` | string | Yes | Name of the Manis payment flow, will be used to search for payinMethod | | `virtualAcountId` | string | Required when creating payin with type `VIRTUAL_ACCOUNT` on Finmo | Identifier of virtual account | | customerId | string | Required when creating payin with type `VIRTUAL_ACCOUNT` on Nium | Unique identifier in Manis of the customer making the PayIn. |

Request

This endpoint expects a string.

Response

payCodeobject

createdAtdatetime

createdBystring

updatedAtdatetime

updatedBystring

pspPayinIdstring

transactionobject

pspPayinMethodstring

manisTransactionIdstring

Headers

Request

Response