Register Operation

Register Operation

POST https://api.payvalida.com/cashout/v1/operation

URL Sandbox: https://api-test.payvalida.com/v1/operation/

This method registers a cashout operation, authorizing the delivery of cash to the requester

Request Body

Name	Type	Description
merchant	string	ID of the commerce/merchant that owns the operation (Max 30 characters).
checksum	string	Checksum encoded in SHA512 (merchant+operation+amount+currency+ document+FIXED_HASH) (512 characters).
operation	string	Operation ID generated by the commerce/merchant. Must be unique (40 characters).
amount	number	Operation amount (20 characters) *In Peru it must only contain one decimal digit
currency	string	ISO code of the currency of the operation (3 characters)
description	string	Short description of the operation (Max 50 characters)
document	number	ID of the end user that executes the operation (Max 20 characters)
otpLength	number	Length of the OTP (default 4, 4 <= otpLength <= 12) (between 4 and 12 characters)
expire	string	Expiration date of the operation (YYYY-MM-DD format, default 30 days) (8 characters).
transactionCost	number	Amount the commerce will charge the user for the operation (default 0) (Max 10 characters).
beneficiaryDocumentType	string	Type of document of the person who will receive the money. Allowed values Peru: - DNI - RUC - CE *Required for Peru merchants
beneficiaryName	string	Name of the person whom will receive the money. *Required for Guatemala and Peru merchants
beneficiaryLastName	string	Lastname of the person whom will receive the money. *Required for Ecuador and Peru merchants
email	string	email of the person whom will receive the money. *Required for Peru merchants
cellphone	string	cellphone without indicative of the person whom will receive the money. *Required for Peru merchants

200 Returns a JSON following this structure:

{  
   "code":"0000",
   “text”:”OK”,
   "data":{  
      "amount":"150000.0",
      “transactionCost”:”2000.0”,
      "currency":"COP”,
      "description":"Retiro de intereses al 15092019",
      "document":"1001007878",
      "otp":"*********",
      “operation”:”1452782”,
      “expire”:”2019-12-31”
      “payvalidaCode”:1234567890,
      “balance”:900234900,
   }
}

Request Example Peru

{
    "merchant": "kuanto_pe",
    "beneficiaryName": "jhon",
    "beneficiaryLastName": "doe",
    "beneficiaryDocumentType": "RUC",
    "operation": "test-globokas-105",
    "amount": 13.3,
    "currency": "PEN",
    "description": "description test globokas 105",
    "document": "48764951234",
    "cellphone": "987654321",
    "email": "[e-mail]",
    "expire": "2024-04-28",
    "checksum": "2ad8a93af77184a42c735143db57fb443eaa2656d29e88d293e9448c75142b5442d91aed293c42ca6aa241ad65c1fd293ca1cb38c344c0f6e89580be07be4d5d"
}

Response data

code: Code of the result, "0000" indicates success, any other indicates an error

text: Contains the message associated with the code that was sent.

data: Contains the transaction data (for successful results)

• amount: Transaction amount

• transactionCost: The cost the user assumes for executing the transaction

• currency: Registered currency for the cashout operation

• description: Description of the operation

• document: Identification number

• otp: Generated OTP for the operation (If the SMS parameter is true, this value is not provided)

• operation: Operation ID, generated by the commerce/merchant

• expire: Expiration date of the operation

• payvalidaCode: Operation ID in Payvalida

• balance: Available balance for operations

The CURRENCY parameter only accepts USD and the local currency, corresponding to the country where the commerce was registered. If USD is received, the system automatically converts it to the local currency.

All registered operations start with a PENDIENTE (pending) status.

The "expire" field indicates the date on which withdrawals cannot be made.