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
Authorization
String
Required
Bearer token for authentication.
Request Body
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. DIRECT
or 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.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.account
Object
Required
Destination account data.
—
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.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.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?