Attributes

• METHOD TYPECash Solution
• PAYMENTS
• PAYOUTS
• REFUNDS
• RECURRING

Introduction

Keepz is a regulated fintech company and digital payment platform available in Italy. The service provides enterprise-grade infrastructure to modernize payment operations for businesses of all sizes.

Supported Countries

• Italy

Supported Currencies

• EUR

Payment (Deposit) Flow

Keepz supports deposit transactions through Cashier, Checkout, and REST API integrations. A pre-deposit DMN is sent to the merchant before the final deposit approval.

Follow these steps to perform a payment using Nuvei REST API integration:

1. Generate a sessionToken

Press here for details.

2. Send a /payment Request

Example Deposit Request

{
  "paymentMethod": "apmgw_Keepz",
  "currency": "EUR",
  "countryCode": "IT",
  "amount": "100.00"
}

Payout (Withdrawal) Flow

Send a /payout request and include the userPaymentOptionId, which contains the user’s previously stored APM account details.

After the transaction is processed, Nuvei sends a DMN that includes the result of the transaction to urlDetails.notificationUrl, which Nuvei recommends including in the /payout request.

Example Payout Request

{
  "paymentMethod": "apmgw_Keepz",
  "currency": "EUR",
  "userPaymentOptionId": "123456789"
}

Payment (Deposit) Flow

TBD

Withdrawal Flow

Send a payout request using the previously generated userPaymentOptionId returned from a successful payment transaction.

Payment Page

Payment (Deposit) Flow

1. Select Keepz on the cashier page.
2. Enter the fiscal code.
3. Enter the deposit amount.
4. Scan the QR code displayed on the Keepz payment page.
5. Complete the transaction using the Keepz application.
6. A success message is displayed and the page closes automatically.

Simply Connect

Payment (Deposit) Flow

Keepz supports Connect and Collect models.

• Connect: Keepz settles funds directly to the merchant according to the agreement between the merchant and Keepz.
• Collect: Nuvei settles funds to the merchant using Nuvei’s arrangement with the payment method provider.

[/single_tab][/ult_tab_element]

DMN

Example DMN Approval Response

{
  "action": "APPROVE",
  "merchantUniqueId": "31fe9fe0-7db4-11ee-afa5-c3b45d3287f5",
  "message": "Deposit approved"
}

Example DMN Decline Response

{
  "action": "DECLINE",
  "merchantUniqueId": "N/A",
  "message": "Sorry, you have reached your deposit limit.",
  "error_code": "DEPOSIT_LIMIT_REACHED"
}

Notes

• The response content type should be application/x-www-form-urlencoded or text/plain.
• Only the action field is mandatory.
• Post-deposit DMNs can be identified using PPP_TransactionID and orderTransactionId.

User Experience

Deposit via Store

1. The customer goes to the merchant and provides cash.
2. The merchant enters the amount and selects the gaming company.
3. An order is activated on a static QR code.
4. The customer scans the QR code using the Keepz application.
5. The system validates the fiscal code against the gaming platform.
6. The customer confirms information sharing.
7. The merchant verifies the customer’s identity.
8. The merchant confirms the transaction details.
9. The customer confirms the destination and amount.
10. The customer completes SCA.
11. A final verification call is sent to Nuvei.
12. A pre-deposit DMN is sent to the merchant for approval or decline.

Deposit via Cashier

1. Select Keepz.
2. Enter fiscal code.
3. Enter amount.
4. Scan the QR code.
5. Complete the payment in the Keepz app.
6. Receive confirmation.

placeholder_20260805_1430_Keepz_QR.png

Withdrawal

1. Select Keepz as the withdrawal method.
2. Enter fiscal code and amount.
3. The withdrawal request is created.
4. The merchant processes the request.
5. The customer receives funds into the Keepz wallet.

placeholder_20260805_1430_Keepz_Withdrawal.png

Testing

PPP testing settings

• APPROVE URL:
  
http://srv-bsf-devppptrunk.gw-4u.com:8080/ppptest/WithdrwalNotificationListener?action=APPROVE

• DECLINE URL:
  
http://srv-bsf-devppptrunk.gw-4u.com:8080/ppptest/WithdrwalNotificationListener?action=DECLINE


Test User

• User: 393220001
• Password: Admin123

DEV Credentials

• Client ID: web-dacc9916-dcad-4430-956c-1ee74088cf96
• Gaming Company ID: 41dcfe23-e86d-4c4f-b7b7-54e9e8605142
• Fiscal Code: RSSMRA85A01H501Z

Additional Test User

• User: 3888888880
• Password: Keepz1234
• Code: 123456

Payout Testing

• Fiscal Number: RSSMRA85M01H501Q
• Automatic Approval Supported

[/vc_column_text][/vc_column][/vc_row]

INTERNAL NOTES