**START OF APM AI AGENT generated content from 7:15pm March 11, 2026 CoPilot Studio**

Peru Digital Wallet Payouts

Introduction

This payment method is not yet available to offer.

Supported Countries

• Peru

Peru

Supported Currencies

• PEN

PEN

REST API

Payment (Deposit) Flow

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

1. Generate a sessionToken

Press here for details.

TBD

Payout (Withdrawal) Flow

To perform a payout for Peru Digital Wallet Payouts:

1. Create a cashier user.
2. Add a UPO for Peru Digital Wallet Payouts, including document and bank details.
3. Send a ‘/payout’ request that includes the previously generated ‘userPaymentOptionId’.

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 Create Cashier User Request

{
  "merchantSiteId": "{{merchantSiteId}}",
  "merchantId": "{{merchantId}}",
  "userTokenId": "PDW_4",
  "clientRequestId": "{{clientRequestId}}",
  "timeStamp": "{{timestamp}}",
  "firstName": "Test",
  "lastName": "Test",
  "address": "TestStreet",
  "city": "TestCity",
  "postal_code": "SW1A1AA",
  "date_of_birth": "1990-01-01",
  "email": "[email protected]",
  "countryCode": "PE",
  "checksum": "{{checksum}}"
}

Example Create Cashier User Response

{
  "internalRequestId": 1763454898512,
  "status": "SUCCESS",
  "errCode": 0,
  "reason": "",
  "merchantId": "5416795427517477813",
  "merchantSiteId": "186111",
  "version": "1.0",
  "clientRequestId": "20251118103458",
  "userId": 1324790111
}

Example Add UPO for Peru Digital Wallet Payouts

{
  "merchantSiteId": "{{merchantSiteId}}",
  "merchantId": "{{merchantId}}",
  "userTokenId": "PDW_4",
  "clientRequestId": "{{clientRequestId}}",
  "timeStamp": "{{timestamp}}",
  "paymentMethodName": "apmgw_Peru_Digital_Wallet_Payouts",
  "apmData": {
    "pdwDocumentType": "1",
    "pdwDocumentNumber": "12345678",
    "pdwBankCode": "037",
    "pdwPhoneNumber": "948474375"
  },
  "checksum": "{{checksum}}"
}

Example Add UPO Response

{
  "internalRequestId": 1763454904427,
  "status": "SUCCESS",
  "errCode": 0,
  "reason": "",
  "merchantId": "5416795427517477813",
  "merchantSiteId": "186111",
  "version": "1.0",
  "clientRequestId": "20251118103504",
  "userPaymentOptionId": 230523346111
}

Example Payout Request

{
  "merchantSiteId": "{{merchantSiteId}}",
  "merchantId": "{{merchantId}}",
  "userTokenId": "PDW_4",
  "clientUniqueId": "12345",
  "amount": "1000",
  "currency": "PEN",
  "userDetails": {
    "birthdate": "1990-01-01"
  },
  "userPaymentOption": {
    "userPaymentOptionId": "230523346111"
  },
  "timeStamp": "{{timestamp}}",
  "checksum": "{{checksum}}"
}

Example Payout Response

{
  "internalRequestId": 1763454915865,
  "status": "SUCCESS",
  "errCode": 0,
  "reason": "",
  "merchantId": "5416795427517477813",
  "merchantSiteId": "186111",
  "version": "1.0",
  "userTokenId": "PDW_4",
  "clientUniqueId": "12345",
  "transactionStatus": "PENDING",
  "paymentMethodErrorCode": "0",
  "userPaymentOptionId": "230523346111",
  "externalTransactionId": "2610000000720617",
  "transactionId": "2610000000000436105",
  "orderId": "318977111"
}

Web SDK

Payment (Deposit) Flow

TBD

Withdrawal Flow

Use the Web SDK to create a payout request for Peru Digital Wallet Payouts using a previously stored payment method:

1. Initialize the SDK and obtain a ‘sessionToken’.
2. Use a server-side integration to create the cashier user and add the Peru Digital Wallet payout UPO.
3. Use the stored ‘userPaymentOptionId’ when initiating a payout flow from your cashier.

The specific withdrawal implementation for Web SDK follows the general Web SDK withdrawal pattern described in Nuvei documentation.

Payment Page

Payment (Deposit) Flow

TBD

Simply Connect

Payment (Deposit) Flow

TBD

DMN

The following is an example DMN for an approved payout transaction for Peru Digital Wallet Payouts:

Example Payout DMN

wdOrderId=24770111&wdRequestId=27938111&gwTrxId=2610000000000459306&notificationType=WITHDRAW_REQUEST_NOTIFICATION&merchantSiteId=186111&merchantGwId=5416795427517477813&merchantLocale=en_US&wdRequestState=Closed&wdRequestStatus=Approved&wdOrderStatus=Settled&settlementType=WITHDRAWAL&gwErrCode=0&gwExtendedErrorCode=0&apmTrxId=2610000000751756&externalTransactionId=658&apmReferenceId=D4C6260C800AF64D49634A23642F40D3&apmErrorCode=0&firstName=Fname&lastName=Lname&userTokenId=13395012olhjk123456678901&zip=123456&city=Madrid&country=PE&phone1=0987654321&email=test%40mymail.com&address=Sancho+el+fuerte+15&amount=1000.00&approvedAmount=1000.00&currency=PEN&userId=Lorem&userPMId=230538260111&paymentMethod=apmgw_Peru_Digital_Wallet_Payouts&version=1.0&pmDisplayName=912414918+Yape&customField1=enracha.es&client_ip=192.168.102.194&wdOrderAmount=1000.00&wdOrderCurrency=PEN&responseTimeStamp=2025-12-09.16%3A00%3A41&feeAmount=0.0&transactionAmount=1000.0&merchantUniqueId=merchuniqueid&upoRegistrationDate=20251208&acquirerBank=MonnetMS+Direct&checksum=1691959237822acc8048903d178581c0a014c5422a7f5edab4212f776dff7e4f

User Experience

Payout – First-time user

1. The user selects the Peru Digital Wallet Payouts payment method in the cashier.
2. The user enters:
   • Document ID (‘documentNumber’).
   • Document type (‘documentType’).
   • Phone number.
   • Wallet (‘Yape’ or ‘Plin’).
   • Withdrawal amount.
3. The user selects withdraw.
4. The cashier displays a confirmation of the payout request.

Screen 1 – Payout details

placeholder – 20260311-1847-Peru-Digital-Wallet-Payouts-UX-1.png

Screen 2 – Successful operation message

placeholder – 20260311-1847-Peru-Digital-Wallet-Payouts-UX-2.png

All User Experience images should be saved as PNG files and grouped into a zip archive named, for example: 20260311-1847-Peru-Digital-Wallet-Payouts-UX.zip.

Testing

Monnet

• How to simulate different statuses:
  • Any status can be updated by sending an email to Monnet with the ‘transactionBankId’.
• Notification URL configuration:
  • The notification URL is configured in the Monnet system.
• APM testing plan:
  • TBD
• Testing details:
  • Document number: ‘12345678’
  • Document type: ‘DNI’
  • Bank list: ‘Yape’ (037), ‘Plin’ (040)
  • Phone number: ‘948474375’

INTERNAL NOTES