Neosurf

Prepaid voucher payment method. Users pay by entering a voucher PIN - no bank account or card required.

Operations: Pay-In ✓ | Pay-Out - | Webhook ✓
Processing: Synchronous voucher redemption
Payment type: Prepaid voucher (PIN-based)

Fields marked with * are required.

Configuration (Mozarto back office)

Field	Description
`username` *	Neosurf API username
`password` *	Neosurf API password
`merchantId` *	Your Neosurf merchant ID
`webhookUrl` *	Your HTTPS endpoint for transaction status updates

Pay-In

POST /v1/api/mozarto/cashier

The user enters their Neosurf voucher PIN in your cashier before you call this endpoint.

Request body

Field	Type	Description
`pspType` *	string	Always `"NEOSURF"`
`type` *	string	Always `"PAYIN"`
`baseamount` *	number	Amount to redeem as a number (e.g. `50.00`)
`currency` *	string	Currency code (e.g. `"EUR"`)
`currencyCode` *	string	Currency code
`userId` *	string	Your internal user/player identifier
`email` *	string	User's email address
`brandId`	string	Brand identifier

Unlike most providers, the user does not get redirected to a hosted page. The voucher PIN is collected in your own interface and submitted directly. No data.url is returned.

Example request

{
  "pspType": "NEOSURF",
  "type": "PAYIN",
  "baseamount": 50.00,
  "currency": "EUR",
  "currencyCode": "EUR",
  "userId": "user_123",
  "email": "player@example.com"
}

Response

{
  "status": "success",
  "isSuccess": true,
  "data": {
    "status": "PENDING",
    "sessionId": "60a74038-5b94-427e-8cff-abc123"
  }
}

Webhook

Mozarto calls your webhookUrl with the transaction result.

The method field will be NEOSURF_PAYIN.

Neosurf

Neosurf#

Configuration (Mozarto back office)#

Pay-In#

Request body#

Example request#

Response#

Webhook#

Neosurf

Configuration (Mozarto back office)

Pay-In

Request body

Example request

Response

Webhook