Dominic Republic

Example PayOut Request and Response

Bank Account Format

Accounts can be provided in either:

  • National Format: Standard bank account number (e.g., 830640009).

  • IBAN Format: The international standard account identifier that includes the national account number. A Dominican IBAN is a 28-character code that starts with the letters DO (e.g., DO42BPDO00000000000830640009).

Both formats represent the same national account. The IBAN simply adds a country code, check digits, and bank identifiers as a prefix to the national account number.

Create payout Dominic Republic

POST https://api.stage.localpayment.com/api/payout

Create a payout order

Headers

Parameter
Type
Required
Description

Authorization

String

Required

Bearer token for authentication.

Request Body

Parameter
Type
Required
Description
Example

externalId

String

Required

A unique reference for this payout. Must be unique in your system. We recommend using UUID4 to ensure uniqueness.

bc38457c-b711-48e3-9bf2-05e07967f9b1

country

String

Required

Processing country. Use ISO 3166-1 alpha-3. Please refer to Country Codes for a full list of supported countries.

DOM

currency

String

Required

Payout currency. If account currency differs, FX may apply per account settings.

DOP

amount

Number

Required

Payout amount. For DOP, specify 2 decimals using a dot.

17156.00

conceptCode

String

Required

Business purpose of the payout. Choose a valid concept from the Concept Code List (e.g., 0039 Remittances, 0040 Freelancer payment).

0039

accountNumber

String

Required

Your Localpayment account number to be debited for the payout.

152.152.00000150

paymentMethod

Object

Required

Payment method object.

paymentMethod.type

String

Required

Must be BankTransfer.

BankTransfer

paymentMethod.code

String

Required

Bank transfer method code (per country list). Code selection can affect currency behavior in bi-monetary markets.

0080

paymentMethod.flow

String

Required

Flow type. DIRECTor REDIRECT.

DIRECT

beneficiary

Object

Required

Final recipient of funds.

beneficiary.type

String

Required

INDIVIDUAL or COMPANY.

INDIVIDUAL

beneficiary.name

String

Required

First name (individual) or legal name (company).

Beneficiary Name

beneficiary.lastName

String

Conditional

Required for INDIVIDUAL. Ignored for COMPANY.

Beneficiary LastName

beneficiary.document

Object

Required

Beneficiary identification.

beneficiary.document.type

String

Required

ID type.

CE

beneficiary.document.id

String

Required

ID number (digits or alphanumerics as issued).

001-1568441-7

beneficiary.userReference

String

Optional

Optional reference/username in your platform.

additional information

beneficiary.email

String

Optional

Beneficiary email for notifications/records.

beneficiary.phone

Object

Optional

Beneficiary phone.

beneficiary.phone.countryCode

String

Optional

Country calling code.

beneficiary.phone.areaCode

String

Optional

Area code (sin leading 0).

beneficiary.phone.number

String

Optional

Local phone number.

beneficiary.birthdate

String

Optional

Individual birthdate / company incorporation date (ISO-8601 YYYY-MM-DD).

1980-01-01

beneficiary.nationality

String

Optional

Beneficiary nationality.

DOM

beneficiary.address

Object

Optional

Beneficiary address.

beneficiary.address.street

String

Optional

Street name.

Av. Centro

beneficiary.address.number

String

Optional

Street/building number.

1234

beneficiary.address.city

String

Optional

City.

Santo Domingo

beneficiary.address.state

String

Optional

Province/State.

Santo Domingo

beneficiary.address.country

String

Optional

Country (ISO code).

DOM

beneficiary.address.zipCode

String

Optional

Postal code.

10014

beneficiary.address.comment

String

Optional

Additional address info (floor, apt., etc.).

Piso 5, Depto B

beneficiary.bank

Object

Required

Destination bank details.

beneficiary.bank.name

String

Required

Account holder full name (as registered at bank).

Beneficiary Name

beneficiary.bank.code

String

Required

101010106

beneficiary.bank.account

Object

Required

Destination account data.

beneficiary.bank.account.type

String

Required

C

beneficiary.bank.account.number

String

Required

The beneficiary's bank account number. Can be provided in national format (e.g., 830640009) for all banks, or IBAN format (e.g., DO42BPDO00000000000830640009) only for LAFISE (111212143) and BHD (101012308).

830640009

sender

Object

Required

Payer entity.

sender.type

String

Required

INDIVIDUAL or COMPANY.

INDIVIDUAL

sender.name

String

Required

First name (individual) or legal name (company).

Sender Name

sender.lastName

String

Conditional

Required for INDIVIDUAL. Ignored for COMPANY.

Sender LastName

sender.document

Object

Optional

Sender identification (type & id).

sender.document.type

String

Optional

Sender document type (can be international document issued by sender’s country).

CE

sender.document.id

String

Optional

Sender ID number.

001-1328441-1

sender.userReference

String

Optional

Optional reference/username in your platform.

additional information

sender.email

String

Optional

Sender email.

sender.phone

Object

Optional

Sender phone.

sender.phone.country

String

Optional

Country calling code.

1

sender.phone.area

String

Optional

Area code.

829

sender.phone.number

String

Optional

Phone number.

1234567

sender.birthdate

String

Optional

Individual birthdate / company incorporation date (ISO-8601 YYYY-MM-DD).

1990-05-20

sender.nationality

String

Optional

Sender nationality.

sender.address

Object

Optional

Sender address.

sender.address.street

String

Optional

Street name.

Av Sender Address

sender.address.number

String

Optional

Street/building number.

1234

sender.address.city

String

Optional

City.

Santo Domingo

sender.address.state

String

Optional

Province/State.

Santo Domingo

sender.address.zipCode

String

Optional

Postal code.

10014

sender.address.comment

String

Optional

Additional address info.

Piso 3

merchant

Object

Required

Your merchant (corporate) profile as registered with Localpayment.

merchant.type

String

Required

INDIVIDUAL or COMPANY.

COMPANY

merchant.name

String

Required

Legal/registered name.

Merchant Name

merchant.lastName

String

Conditional

Required only if INDIVIDUAL. Ignored for COMPANY.

Merchant LastName

merchant.document

Object

Optional

Merchant identification (type & id).

merchant.document.type

String

Optional

Document type.

RNC

merchant.document.id

String

Optional

Document number.

401-50625-4

merchant.userReference

String

Optional

Optional internal reference/ID.

additional information

merchant.email

String

Optional

Merchant email.

merchant.phone

Object

Optional

Merchant phone.

merchant.phone.country

String

Optional

Country calling code.

1

merchant.phone.area

String

Optional

Area code.

829

merchant.phone.number

String

Optional

Phone number.

7654321

merchant.birthdate

String

Optional

Incorporation date (company) or birthdate (individual), ISO-8601 YYYY-MM-DD.

2001-01-01

merchant.nationality

String

Optional

Merchant nationality.

merchant.address

Object

Optional

Merchant address.

merchant.address.street

String

Optional

Street name.

Av Merchant Address

merchant.address.number

String

Optional

Street/building number.

1234

merchant.address.city

String

Optional

City.

Santo Domingo

merchant.address.state

String

Optional

Province/State.

Santo Domingo

merchant.address.country

String

Optional

Country.

DOM

merchant.address.zipCode

String

Optional

Postal code.

10014

merchant.address.comment

String

Optional

Additional address info.

Oficina 12

comment

String

Optional

Free-text note for your internal tracking or reconciliation.

Payroll batch 08/15

Request example

{
    "externalId": "53ad038a-14ee-4642-b836-5d8ff7c5e4bd",
    "country": "DOM",
    "currency": "DOP",
    "amount": 1000.0,
    "paymentMethod": {
        "type": "BankTransfer",
        "code": "0080",
        "flow": "direct"
    },
    "beneficiary": {
        "name": "John",
        "lastName": "Doe",
        "type": "INDIVIDUAL",
        "document": {
            "type": "CE",
            "id": "001-1568441-7"
        },
        "bank": {
            "name": "BANFONDESA",
            "code": "434911008",
            "account": {
                "number": "830640009",
                "type": "S"
            }
        }
    },
    "sender": {
        "type": "INDIVIDUAL",
        "name": "Alicia",
        "lastName": "Doe",
        "document": {
            "type": "CE",
            "id": "001-2842441-2"
        }
    },
    "merchant": {
        "type": "COMPANY",
        "name": "Company X"
    },
    "accountNumber": "214.214.00000001",
    "conceptCode": "0001"
}

Response example

{
    "externalId": "53ad038a-14ee-4642-b836-5d8ff7c5e4bd",
    "internalId": "b4e3b28a-fb1b-4423-ae14-6a7e07b34a26",
    "paymentMethod": {
        "code": "0080",
        "name": "CC",
        "description": "ACH",
        "paymentMethodType": "BankTransfer"
    },
    "country": "DOM",
    "currency": "DOP",
    "amount": 1000.0,
    "accountNumber": "214.214.00000001",
    "clientCode": "0001",
    "clientName": "Acme",
    "status": {
        "code": "100",
        "description": "Received",
        "detail": "The payout was received"
    },
    "beneficiary": {
        "bank": {
            "name": "BANFONDESA",
            "code": "434911008",
            "countryISOCode3": null,
            "branch": null,
            "account": {
                "number": "830640009",
                "type": "S",
                "alias": null,
                "pixKey": null,
                "phone": null
            }
        },
        "type": "INDIVIDUAL",
        "name": "John",
        "lastname": "Doe",
        "document": {
            "type": "CE",
            "id": "001-1568441-7"
        },
        "userReference": null,
        "email": null,
        "phone": null,
        "birthdate": "0001-01-01T00:00:00",
        "nationality": null,
        "address": null
    },
    "merchant": {
        "type": "COMPANY",
        "name": "Company X",
        "lastname": null,
        "document": null,
        "userReference": null,
        "email": null,
        "phone": null,
        "birthdate": "0001-01-01T00:00:00",
        "nationality": null,
        "address": null
    },
    "sender": {
        "type": "INDIVIDUAL",
        "name": "Alicia",
        "lastname": "Doe",
        "document": {
            "type": "CE",
            "id": "001-2842441-2"
        },
        "userReference": null,
        "email": null,
        "phone": null,
        "birthdate": "0001-01-01T00:00:00",
        "nationality": null,
        "address": null
    },
    "comment": null,
    "exchangeRateToken": null,
    "date": {
        "creationDate": "2025-09-05T15:44:22.7066039+00:00",
        "processedDate": "2025-09-05T15:44:22.7067727+00:00"
    },
    "errors": null,
    "internalLoteID": "137799"
}

Last updated

Was this helpful?