Skip to main content

Payout to Peru (Bank Transfer)

To send a payout to Peru, set the payout_method to BANK_TRANSFER. The required_PE object must include both the bank_code, account_type, account_number, tax_id, tax_id_type, email, full_name of the recipient.

  POST https://api-sandbox.letpay.io/payoutTransaction

Body​

tax_id_type​

string, required

This field specifies the type of identification document.

Allowed values:

  • CE: Foreign resident card in Colombia and Peru. For Peru, max length is 12 characters.
  • DNI: Identity Document in Peru. Must be 8 characters in length.
  • PAS: Passport in Peru.
  • RUC: Tax ID number in Peru. Must be 11 characters in length.

tax_id​

string, required

This field contains the identification document number.

  • For DNI in Peru: It must be 8 characters in length.
  • For RUC in Peru: It must be 11 characters in length.
  • For CE in Peru: The max length is 12 characters.
  • For PAS in Peru: The max length is 12 characters.

bank_code​

string, required

This field contains the bank code.

account_type​

string, required

This field defines the bank account type.

Allowed values:

  • CC: Current Account in Peru.
  • CA: Savings Account in Peru.
  • CM: "Cuenta maestra" in Peru.

account_number​

string, required

This field contains the bank account number.

  • If the bank_code is 002 (BCP) and the account_type is CC, it must be 13 digits in length.
  • If the bank_code is 002 (BCP) and the account_type is CA, it must be 14 digits in length.
  • If the bank_code is different than 002, you must send the CCI (Código de cuenta interbancaria). This must contain exactly 20 digits and be presented without spaces, hyphens, or special characters.

Example Request​

{
    "payoutTransactions": [
        {
            "original_amount": 200.00,
            "original_currency": "PEN",
            "payment_currency": "PEN",
            "payment_country": "PE",
            "payout_method": "BANK_TRANSFER",
            "contract_id": "MY_PAYOUT_CONTRACT_ID",
            "reference_id": "MY_REFERENCE_ID",
            "notification_url": "https://my.notification.url/callback",
            "ttl": 0,
            "required_PE": {
                "bank_code": "003",
                "account_type": "CA",
                "account_number": "00316301312597216937",
                "tax_id": "70015101",
                "tax_id_type": "DNI",
                "email": "[email protected]",
                "full_name": "Alice Sonnentag"
            }
        }
    ]
}

Example Response​

{
    "payoutTransactionResponses": [
        {
            "tx_id": "PAYOUT_REFERENCE_ID",
            "reference_id": "MY_REFERENCE_ID",
            "amount": 200,
            "original_amount": 200,
            "original_asset": "PEN",
            "customer_fees": 0,
            "customer_amount": 200,
            "merchant_fees": 0,
            "merchant_amount": 200,
            "asset": "PEN",
            "banking_data": "003:CA:00316301312597216937",
            "status": "CREATED"
        }
    ],
    "refresh_token": "MY_ACCESS_TOKEN"
}