# xMoney Card Issuing API

API reference for the standard xMoney Card Issuing whitelabel service.
Use these endpoints to onboard customers, complete KYC, manage accounts,
issue cards, fund accounts, and monitor transactions.


Version: 1.0

## Servers

Staging
```
https://issuing-stage.xmoney.com/v1
```

Production
```
https://issuing.xmoney.com/v1
```

## Security

### BearerAuth

Type: http
Scheme: bearer
Bearer Format: JWT

### PartnerApiKey

Type: apiKey
In: header
Name: x-partner-api-key

### PartnerId

Type: apiKey
In: header
Name: x-partner-id

## Download OpenAPI description

[xMoney Card Issuing API](https://docs.xmoney.com/_bundle/card_issuing_api/reference.yaml)

## Auth

Customer registration, login, refresh, and 2FA.

### Register customer via partner API key

 - [POST /auth/register/partner](https://docs.xmoney.com/card_issuing_api/reference/auth/registercustomerwithpartnerkey.md)

### Login customer via partner API key

 - [POST /auth/login/partner](https://docs.xmoney.com/card_issuing_api/reference/auth/logincustomerwithpartnerkey.md)

### Register with email and password

 - [POST /auth/register/email](https://docs.xmoney.com/card_issuing_api/reference/auth/registerwithemail.md)

### Verify email registration OTP

 - [POST /auth/register/email/verify](https://docs.xmoney.com/card_issuing_api/reference/auth/verifyemailregistration.md)

### Create wallet registration challenge

 - [POST /auth/register/wallet/challenge](https://docs.xmoney.com/card_issuing_api/reference/auth/createwalletregistrationchallenge.md)

### Register with signed wallet challenge

 - [POST /auth/register/wallet](https://docs.xmoney.com/card_issuing_api/reference/auth/registerwithwallet.md)

### Verify wallet registration OTP

 - [POST /auth/register/wallet/verify](https://docs.xmoney.com/card_issuing_api/reference/auth/verifywalletregistration.md)

### Login with email and password

 - [POST /auth/login/email](https://docs.xmoney.com/card_issuing_api/reference/auth/loginwithemail.md)

### Create wallet login challenge

 - [POST /auth/login/wallet/challenge](https://docs.xmoney.com/card_issuing_api/reference/auth/createwalletloginchallenge.md)

### Login with signed wallet challenge

 - [POST /auth/login/wallet](https://docs.xmoney.com/card_issuing_api/reference/auth/loginwithwallet.md)

### Refresh access token

 - [POST /auth/refresh](https://docs.xmoney.com/card_issuing_api/reference/auth/refreshaccesstoken.md)

### Send 2FA code

 - [POST /auth/2fa/send](https://docs.xmoney.com/card_issuing_api/reference/auth/sendtwofactorcode.md)

### Verify 2FA code

 - [POST /auth/2fa/verify](https://docs.xmoney.com/card_issuing_api/reference/auth/verifytwofactorcode.md)

## KYC

Customer KYC and hosted verification.

### Get KYC status

 - [GET /kyc](https://docs.xmoney.com/card_issuing_api/reference/kyc/getkycstatus.md)

### Submit customer agreements

 - [POST /kyc/agreement](https://docs.xmoney.com/card_issuing_api/reference/kyc/submitkycagreement.md)

### Submit customer personal information

 - [POST /kyc/personal-info](https://docs.xmoney.com/card_issuing_api/reference/kyc/submitkycpersonalinfo.md)

### Submit customer residence

 - [POST /kyc/residence](https://docs.xmoney.com/card_issuing_api/reference/kyc/submitkycresidence.md)

### Submit customer gender

 - [POST /kyc/gender](https://docs.xmoney.com/card_issuing_api/reference/kyc/submitkycgender.md)

### Submit customer birthplace

 - [POST /kyc/birthplace](https://docs.xmoney.com/card_issuing_api/reference/kyc/submitkycbirthplace.md)

### Submit wealth and income

 - [POST /kyc/wealth-and-income](https://docs.xmoney.com/card_issuing_api/reference/kyc/submitkycwealthandincome.md)

### Submit PEP information

 - [POST /kyc/pep](https://docs.xmoney.com/card_issuing_api/reference/kyc/submitkycpep.md)

### Confirm PEP information

 - [POST /kyc/confirm-pep](https://docs.xmoney.com/card_issuing_api/reference/kyc/confirmkycpep.md)

### Start hosted ID verification

 - [POST /kyc/id-verification/start](https://docs.xmoney.com/card_issuing_api/reference/kyc/startidverification.md)

### Start hosted proof-of-address verification

 - [POST /kyc/poa-verification/start](https://docs.xmoney.com/card_issuing_api/reference/kyc/startpoaverification.md)

## Accounts

Customer account management.

### List accounts

 - [GET /accounts](https://docs.xmoney.com/card_issuing_api/reference/accounts/listaccounts.md)

### Create account

 - [POST /accounts](https://docs.xmoney.com/card_issuing_api/reference/accounts/createaccount.md)

### Close account

 - [POST /accounts/{accountId}/close](https://docs.xmoney.com/card_issuing_api/reference/accounts/closeaccount.md)

## Cards

Card issuing and lifecycle management.

### List cards

 - [GET /cards](https://docs.xmoney.com/card_issuing_api/reference/cards/listcards.md)

### Issue card

 - [POST /cards](https://docs.xmoney.com/card_issuing_api/reference/cards/issuecard.md)

### Freeze card

 - [POST /cards/{id}/freeze](https://docs.xmoney.com/card_issuing_api/reference/cards/freezecard.md)

### Unfreeze card

 - [POST /cards/{id}/unfreeze](https://docs.xmoney.com/card_issuing_api/reference/cards/unfreezecard.md)

### Reissue card

 - [POST /cards/{id}/reissue/{reason}](https://docs.xmoney.com/card_issuing_api/reference/cards/reissuecard.md)

### Get card secrets

 - [GET /cards/{id}/secrets](https://docs.xmoney.com/card_issuing_api/reference/cards/getcardsecrets.md)

### Get Apple Pay provisioning payload

 - [POST /cards/{id}/provisioning/apple-pay](https://docs.xmoney.com/card_issuing_api/reference/cards/provisionapplepay.md)

### Get Google Pay provisioning payload

 - [GET /cards/{id}/provisioning/google-pay](https://docs.xmoney.com/card_issuing_api/reference/cards/provisiongooglepay.md)

## Topups

Fiat and crypto funding.

### List topups

 - [GET /topups](https://docs.xmoney.com/card_issuing_api/reference/topups/listtopups.md)

### Get topup limits

 - [GET /topups/limits](https://docs.xmoney.com/card_issuing_api/reference/topups/gettopuplimits.md)

### Get topup usage

 - [GET /topups/usage](https://docs.xmoney.com/card_issuing_api/reference/topups/gettopupusage.md)

### Get topup details

 - [GET /topups/{id}](https://docs.xmoney.com/card_issuing_api/reference/topups/gettopupbyid.md)

### Create fiat topup order

 - [POST /topups/fiat](https://docs.xmoney.com/card_issuing_api/reference/topups/createfiattopup.md)

### Get supported cryptocurrencies

 - [GET /topups/crypto/currencies](https://docs.xmoney.com/card_issuing_api/reference/topups/getsupportedcryptotopupcurrencies.md)

### Get crypto topup limits

 - [GET /topups/crypto/limits](https://docs.xmoney.com/card_issuing_api/reference/topups/getcryptotopuplimits.md)

### Get crypto exchange rate

 - [POST /topups/crypto/exchange-rate](https://docs.xmoney.com/card_issuing_api/reference/topups/getcryptoexchangerate.md)

### Compute crypto topup fees

 - [POST /topups/crypto/fees](https://docs.xmoney.com/card_issuing_api/reference/topups/computecryptotopupfees.md)

### Create crypto topup order

 - [POST /topups/crypto](https://docs.xmoney.com/card_issuing_api/reference/topups/createcryptotopup.md)

## Transactions

Transaction history and 3D Secure.

### List transactions

 - [GET /transactions](https://docs.xmoney.com/card_issuing_api/reference/transactions/listtransactions.md)

### List pending 3D Secure transactions

 - [GET /transactions/3d-secure](https://docs.xmoney.com/card_issuing_api/reference/transactions/listpending3dstransactions.md)

### Respond to a pending 3D Secure transaction

 - [PATCH /transactions/3d-secure/{transactionAuthId}](https://docs.xmoney.com/card_issuing_api/reference/transactions/respondto3dstransaction.md)

### Get transaction by id

 - [GET /transactions/{transactionId}](https://docs.xmoney.com/card_issuing_api/reference/transactions/gettransactionbyid.md)

