> ## Documentation Index > Fetch the complete documentation index at: https://doc.raliopay.com/llms.txt > Use this file to discover all available pages before exploring further. # Create card payin > Create a new card payin order. If payer data is not provided, the payer will be the account owner. ## OpenAPI ````yaml post /api/v1/account/users/{uid}/accounts/{aid}/card-payins openapi: 3.0.0 info: contact: email: support@tropipay.com name: Tropipay Support url: https://help.tropipay.com/contacto/ description: Banking as a service API. title: RALIO API version: '1.0' servers: - url: https://sandbox-revo-api.raliopay.com security: [] paths: /api/v1/account/users/{uid}/accounts/{aid}/card-payins: post: tags: - payins summary: Create card payin description: >- Create a new card payin order. If payer data is not provided, the payer will be the account owner. parameters: - description: User ID in: path name: uid required: true schema: type: string - description: Account ID in: path name: aid required: true schema: type: string requestBody: $ref: '#/components/requestBodies/dto.CreateCardPayinRequest' responses: '201': description: Created content: application/json: schema: $ref: '#/components/schemas/dto.PaymentUrlResponse' '400': description: Bad Request content: application/json: schema: $ref: '#/components/schemas/httperror.ErrResponse' '401': description: Unauthorized content: application/json: schema: $ref: '#/components/schemas/httperror.ErrResponse' '500': description: Internal Server Error content: application/json: schema: $ref: '#/components/schemas/httperror.ErrResponse' security: - ApiKeyAuth: [] components: requestBodies: dto.CreateCardPayinRequest: content: application/json: schema: $ref: '#/components/schemas/dto.CreateCardPayinRequest' description: Funding details required: true schemas: dto.PaymentUrlResponse: properties: order: $ref: '#/components/schemas/dto.OrderResponse' paymentUrl: example: https://payment-gateway.example.com/pay/abc123 type: string type: object httperror.ErrResponse: properties: error: $ref: '#/components/schemas/httperror.ErrorData' type: object dto.CreateCardPayinRequest: properties: amount: example: 5000 type: integer currency: enum: - EUR - USD example: EUR type: string payer: $ref: '#/components/schemas/dto.PayerData' reference: example: CARD-PAY-2025-001234 type: string urlFailed: example: https://example.com/payment/failed type: string urlSuccess: example: https://example.com/payment/success type: string required: - amount - currency - reference - urlFailed - urlSuccess type: object dto.OrderResponse: properties: canceledAt: example: '2025-01-15T10:35:00Z' type: string counterparty: description: >- Counterparty is the party on the other side of the order, resolved per operation type: sender/cardholder for incomes, recipient/destination for expenses. May be empty when not available. example: John Doe type: string createdAt: example: '2025-01-15T10:30:00Z' type: string destination: $ref: '#/components/schemas/domain.Money' detailUrl: example: /api/v1/account/orders/e5f6a7b8-c9d0-4e1f-2a3b-4c5d6e7f8a9b type: string displayType: example: Transaction Type type: string failedAt: example: '2025-01-15T10:35:00Z' type: string fee: $ref: '#/components/schemas/domain.Money' fx: $ref: '#/components/schemas/dto.FXResponse' id: example: e5f6a7b8-c9d0-4e1f-2a3b-4c5d6e7f8a9b type: string origin: $ref: '#/components/schemas/domain.Money' reference: example: PAY-2025-001234 type: string reversedAt: example: '2025-01-15T10:35:00Z' type: string settledAt: example: '2025-01-15T10:35:00Z' type: string state: example: PENDING type: string type: example: TRANSACTION_TYPE type: string updatedAt: example: '2025-01-15T10:30:05Z' type: string type: object httperror.ErrorData: properties: code: $ref: '#/components/schemas/httperror.ErrorCode' details: items: $ref: '#/components/schemas/httperror.ErrorDetails' type: array message: type: string type: $ref: '#/components/schemas/httperror.ErrorType' type: object dto.PayerData: properties: address: example: 123 Main Street type: string birthdate: example: '1990-05-15' type: string city: example: Madrid type: string country: example: ES type: string documentNumber: example: 12345678A type: string documentType: enum: - NATIONAL_ID - RESIDENCE_CARD - PASSPORT - DRIVING_LICENSE - CIF example: NATIONAL_ID type: string email: example: john.doe@example.com type: string name: example: John type: string phone: example: '+34612345678' type: string postalCode: example: '28001' type: string province: example: Madrid type: string surname: example: Doe type: string required: - address - birthdate - city - country - documentNumber - documentType - email - name - phone - postalCode - surname type: object domain.Money: properties: amount: description: 'Amount in cents. Ex: 12345 = 123.45€' example: 1000 type: integer currency: description: USD, EUR, etc. enum: - EUR - USD - MXN - CAD - BRL - COP - PEN - BOB - CLP - ARS - UYU - PYG - CNY - HKD - MYR - USDT - USDC - EURC - BTC - ETH example: CURRENCY type: string required: - currency type: object dto.FXResponse: properties: pair: example: CURRENCY/CURRENCY type: string rate: example: 1.08 type: number timestamp: example: '2025-01-15T10:30:00Z' type: string type: object httperror.ErrorCode: enum: - INVALID_REQUEST - UNAUTHORIZED - FORBIDDEN - NOT_FOUND - INTERNAL_SERVER_ERROR - UNKNOWN_ERROR - NOT_IMPLEMENTED - TOO_MANY_REQUESTS - QUOTE_EXPIRED - BAD_GATEWAY type: string x-enum-varnames: - InvalidRequestCode - UnauthorizedCode - ForbiddenCode - NotFoundCode - InternalServerCode - UnknownErrorCode - NotImplementedCode - TooManyRequestsCode - QuoteExpiredCode - BadGatewayCode httperror.ErrorDetails: properties: field: type: string message: type: string type: object httperror.ErrorType: enum: - VALIDATION_ERROR - CONFLICT_ERROR - UNPROCESSABLE_ERROR - AUTHENTICATION_ERROR - AUTHORIZATION_ERROR - NOT_FOUND_ERROR - INTERNAL_ERROR - NOT_IMPLEMENTED_ERROR - UNKNOWN_ERROR - RATE_LIMIT_ERROR - BAD_GATEWAY_ERROR type: string x-enum-varnames: - ValidationError - ConflictError - UnprocessableError - AuthenticationError - AuthorizationError - NotFoundError - InternalError - NotImplementedError - UnknownError - RateLimitError - BadGatewayError securitySchemes: ApiKeyAuth: type: http scheme: bearer bearerFormat: JWT description: API Key for accessing management endpoints x-mint-auth-type: bearer ````