> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nadcab.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Create transfer

> Send the fields returned by Required transaction fields. sender* and receiver* are per-transfer fields; you do not need to create sender or receiver records first.



## OpenAPI

````yaml POST /remittance/transfer
openapi: 3.1.0
info:
  title: Nadcab Labs Card Issuing API
  version: 1.0.0
  description: >-
    Issue and manage crypto-funded virtual and physical cards, cardholders,
    wallet deposits and remittances.
servers:
  - url: https://cc.nadcab.com/api/v1
    description: Production
security:
  - bearerAuth: []
tags:
  - name: Card BINs
    description: List card BINs you can issue on.
  - name: Account
    description: Wallet balance, deposits and withdrawals.
  - name: API settings
    description: Webhook URL, IP allowlist and card data encryption key.
  - name: Cards
    description: Create, fund, freeze and close cards.
  - name: Cardholders
    description: Create and manage cardholders for B2C card programs.
  - name: Remittance
    description: Send fiat bank transfers funded from your wallet.
paths:
  /remittance/transfer:
    post:
      tags:
        - Remittance
      summary: Create transfer
      description: >-
        Send the fields returned by Required transaction fields. sender* and
        receiver* are per-transfer fields; you do not need to create sender or
        receiver records first.
      operationId: createTransfer
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                common:
                  type: object
                  properties:
                    apiOrderNo:
                      type: string
                      description: Order number
                    payoutCurrency:
                      type: string
                      description: Currency
                    transferType:
                      type: string
                      description: Transfer type
                    payoutMethod:
                      type: string
                      description: Payout method
                    transferAmount:
                      type: string
                      description: Transfer amount
                    purposeOfRemittance:
                      type: string
                      description: Purpose of remittance
                  required:
                    - apiOrderNo
                    - payoutCurrency
                    - transferType
                    - payoutMethod
                    - transferAmount
                    - purposeOfRemittance
                senderDetail:
                  type: object
                  properties:
                    senderBeneficiaryRelationship:
                      type: string
                      description: Relationship between sender and receiver
                    senderSourceOfFund:
                      type: string
                      description: Sender source of funds
                    senderFirstName:
                      type: string
                      description: Sender first name
                    senderLastName:
                      type: string
                      description: Sender last name
                    senderGender:
                      type: string
                      description: Sender gender
                    senderMobileNumber:
                      type: string
                      description: Sender phone number
                    senderIdType:
                      type: string
                      description: Sender ID document type
                    senderIdNumber:
                      type: string
                      description: Sender ID number
                    senderDateOfBirth:
                      type: string
                      description: Sender date of birth, yyyy-MM-dd
                    senderNationality:
                      type: string
                      description: Sender nationality
                    senderIdIssueCountry:
                      type: string
                      description: Sender ID document issuing country or region
                    senderCountry:
                      type: string
                      description: Sender country of residence
                    senderAddress:
                      type: string
                      description: Sender residential address
                  required:
                    - senderBeneficiaryRelationship
                    - senderSourceOfFund
                    - senderFirstName
                    - senderLastName
                    - senderGender
                    - senderMobileNumber
                    - senderIdType
                    - senderIdNumber
                    - senderDateOfBirth
                    - senderNationality
                    - senderIdIssueCountry
                    - senderCountry
                    - senderAddress
                receiverDetail:
                  type: object
                  properties:
                    receiverNativeFirstName:
                      type: string
                      description: Receiver first name in native script
                    receiverNativeLastName:
                      type: string
                      description: Receiver last name in native script
                    receiverIdType:
                      type: string
                      description: Receiver ID number type
                    receiverIdNumber:
                      type: string
                      description: Receiver ID number
                    receiverMobileNumber:
                      type: string
                      description: Receiver phone number
                    receiverBankAccountNumber:
                      type: string
                      description: Receiver bank account number
                  required:
                    - receiverNativeFirstName
                    - receiverNativeLastName
                    - receiverIdType
                    - receiverIdNumber
                    - receiverMobileNumber
                    - receiverBankAccountNumber
              required:
                - common
                - senderDetail
                - receiverDetail
            example:
              merchantOrderNo: tr123456789000001
              payoutCurrency: CNY
              transferType: '3'
              payoutMethod: '1'
              senderBeneficiaryRelationship: '1'
              transferAmount: '50.00'
              senderSourceOfFund: '3'
              purposeOfRemittance: '1'
              senderFirstName: SAN
              senderLastName: ZHANG
              senderGender: Female
              senderMobileNumber: '81'
              senderIdType: '61'
              senderIdNumber: '95'
              senderDateOfBirth: '2025-09-06'
              senderNationality: US
              senderIdIssueCountry: '32'
              senderCountry: US
              senderAddress: xiangdong 41216
              receiverNativeFirstName: Liguo
              receiverNativeLastName: Pin
              receiverIdType: '12'
              receiverIdNumber: '4'
              receiverMobileNumber: '99'
              receiverBankAccountNumber: '6222000000000000000'
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
                properties:
                  code:
                    type: integer
                  msg:
                    type: string
                  data:
                    type: object
                    properties:
                      merchant_order_no:
                        type: string
                        description: Platform order number
                      api_order_no:
                        type: string
                        description: Developer reference
                      status:
                        type: string
                        description: Status
                    required:
                      - merchant_order_no
                      - api_order_no
                      - status
                required:
                  - code
                  - msg
                  - data
              example:
                code: 200
                msg: success
                data:
                  merchant_order_no: TR20260517122246609138
                  api_order_no: 1232312312313x
                  status: wait_process
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        Your API key from Console → Settings → Key & Access, sent as
        `Authorization: Bearer ncl_...`.

````