Build Fully Owned Experiences

// Create a new user
const response = await fetch('https://api.hoppa.global/api/v2/users', {
  method: 'POST',
  headers: {
    'x-api-key': 'YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    firstName: 'John',
    lastName: 'Doe',
    email: 'john@example.com',
    phone: '+49151XXXXXXXX',
    externalUserId: 'your-internal-user-id'
  })
});

// Response
{
  "id": "usr_abc123",
  "firstName": "John",
  "lastName": "Doe",
  "email": "john@example.com",
  "phone": "+49151XXXXXXXX",
  "externalUserId": "your-internal-user-id"
}

// Order a card for a user
const response = await fetch('https://api.hoppa.global/api/v2/cards', {
  method: 'POST',
  headers: {
    'x-api-key': 'YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    userId: '{userId}',
    cardTypeId: '{cardTypeId}',
    currency: 'USD',
    cardName: 'John Doe',
    phone: '+49151XXXXXXXX',
    phoneCode: '49',
    externalCardId: 'your-internal-card-id',
    billingAddress: {
      city: 'Ljubljana',
      line1: 'Slovenska Cesta 54',
      line2: null,
      state: '',
      country: 'SVN',
      postalCode: '1000'
    }
  })
});

// Response — card ID returned for subsequent operations
{
  "id": "crd_xyz789",
  "userId": "usr_abc123",
  "cardTypeId": "{cardTypeId}",
  "currency": "USD",
  "cardName": "John Doe",
  "status": "pending_activation"
}