Webhooks

Vesseo must implement a url to receive via webhook: Status KYC, Send Payment Card.

HTTP Header Signature

Sign the payload timestamp.SANDBOX_VIBRANT_HOST.body using the SANDBOX_SIGNING_KEY

Signature: t=, s=<base64 encoded signature

{
    SEP01_TOML: "https://stg-backend-card.alfredpay.app/.well-known/stellar.toml",
    SANDBOX_VESSEO_HOST: "https://api-dev.vibrantapp.com" 
}

# WEBHOOKS - KYC and Card Status

```enum UserStatusEnum {
  updateRequired = 'updateRequired', // New User or dont finish KYC process
  pending = 'pending', // User is pending KYC approval
  rejected = 'rejected',  // User's KYC was rejected
  approved = 'approved',  // User's KYC was approved and user is Active without card
}

 enum CardStateEnum {
  /* Description: State in which the card is */
  ACTIVE = 'ACTIVE', // Card is active and ready for transactions
  CREATED = 'CREATED', // Card was created but is not yet active
  EMBOSSED = 'EMBOSSED', // Card is embossed (Only applies to physical cards)
  RE_EMBOSSED = 'RE_EMBOSSED', // Card was re-embossed (Only applies to physical cards)
  SUSPENDED = 'SUSPENDED', // Card is suspended and cannot perform certain operations
  BLOCKED = 'BLOCKED', // Card is blocked
}

const userAddress // Stellar Wallet Address Public Key
const cardId // Card ID UUID format
const lastFour // Last four digits of the card number

const params = {
  eventType: 'KYC',
  userAddress,
  status: UserStatusEnum,
};

const params = {
  eventType: 'activateCard',
  userAddress,
  cardId,
  cardType: ['VIRTUAL'],
  state: {
    virtual: 'ACTIVE',
  },
  lastFour
};


const params = {
  eventType: 'cardStatusUpdate',
  userAddress,
  cardId,
  cardType: ['VIRTUAL'],
  state: {
    virtual: CardStatusEnum,
  },
  lastFour
};

const params = {
  eventType: 'physicalCard',
  userAddress,
  cardId,
  cardType: ['VIRTUAL', 'PHYSICAL'],
  state: {
    virtual: 'ACTIVE',
    physical: 'CREATED',
  },
  lastFour,
};
```

POST /webhook

2KB

webhook (1).md