Skip to content

Cross-border card transfers

For cross-border transfers, use one of the transaction types listed below. Ask your manager or the Tech Support Team which transaction type is appropriate for your shop.

  • Payout;

  • P2P transfer — in this case the sender's card details are passed in the request body.

To obtain information about fee calculation for a transfer via /p2ps in advance, send a checking P2P transfer availability request.

Payout

Send a POST request to https://gateway.bepaid.by/transactions/payouts with the following parameters:
object
amount
required
 bigInteger
Amount in minor currency units. For example, 32.45 must be sent as 3245.
currency
required
 string
Currency in ISO-4217 format, for example USD.
description
required
 string (255)
Payout description.
tracking_id
required
 string (255)
Transaction identifier in the merchant's system.
notification_url
 string
URL to which notifications will be sent. The notification request format is the same as the transaction response format.
object
number
required
 string (19)
Card number.
holder
required
 string (32)
Cardholder name.
object
Sender details.
birth_date
required
 string
Sender's date of birth in ISO 8601 YYYY-MM-DD format.
object
Transfer recipient details.
first_name
required
 string (30)
Recipient's first name.
last_name
required
 string (30)
Recipient's last name.
object
Sender details
first_name
required
 string (30)
Sender's first name.
last_name
required
 string (30)
Sender's last name.
country
required
 string
Sender's country in ISO 3166-1 alpha-2 format.
city
required
 string (60)
Sender's city.
state
 string
Sender's state or region. See more here.
zip
required
 string
Sender's postal code.
address
required
 string (255)
Sender's address.
object
Section containing additional transaction information.
object
Information about the sender's identification document.
document_type
 string (50)
Identification document type. Possible values are listed here.
document_number
required
 string (50)
Identification document number.
Request example 
{
  "request": {
    "amount": 10000,
    "currency": "AMD",
    "description": "Test transaction",
    "tracking_id": "12345698",
    "sender": {
      "birth_date": "1990-10-20"
    },
    "recipient_billing_address": {
      "first_name": "John",
      "last_name": "Doe"
    },
    "sender_billing_address": {
      "first_name": "Alex",
      "last_name": "Smith",
      "country": "GB",
      "city": "London",
      "state": "Greater London",
      "zip": "SW1A 1AA",
      "address": "104 1st Street"
    },
    "recipient_credit_card": {
      "number": "4318290080737105",
      "holder": "John Doe"
    },
    "additional_data": {
      "customer_id_data": {
        "document_number": "AA123456"
      }
    }
  }
}
Response example 
{
  "uid": "6a79932b-fedd-44dc-bdbc-5062d299a6c9",
  "code": "S.0000",
  "friendly_message": "Transaction successful.",
  "status": "successful",
  "amount": 10000,
  "currency": "AMD",
  "description": "Test transaction",
  "type": "payout",
  "tracking_id": "12345698",
  "message": "Transaction successful.",
  "test": false,
  "created_at": "2026-10-19T13:25:45.390Z",
  "updated_at": "2026-10-19T13:25:50.146Z",
  "paid_at": "2026-10-19T13:25:50.104Z",
  "manually_corrected_at": null,
  "language": "en",
  "redirect_url": "https://gateway.bepaid.by/process/6a79932b-fedd-44dc-bdbc-5062d299a6c9",
  "status_code": null,
  "customer": {
    "ip": null,
    "email": null,
    "device_id": null,
    "birth_date": "1990-10-20",
    "external_id": null,
    "first_name": "Alex",
    "last_name": "Smith",
    "middle_name": null,
    "address": "104 1st Street",
    "country": "GB",
    "city": "London",
    "zip": "SW1A 1AA",
    "state": "Greater London",
    "phone": null
  },
  "recipient": {
    "customer": {
      "first_name": "John",
      "last_name": "Doe",
      "middle_name": null,
      "address": null,
      "country": null,
      "city": null,
      "zip": null,
      "state": null,
      "phone": null
    },
    "payment_method": {
      "holder": "John Doe",
      "stamp": "215d05bcbd4f138de201e01105118f174733eeb0c32d0510cdd476c27fefce22",
      "brand": "visa",
      "last_4": "7105",
      "first_1": "4",
      "bin": "431829",
      "bin_8": "43182900",
      "hash_bin9": null,
      "issuer_country": "AM",
      "issuer_name": "ID Bank CJSC",
      "product": "F",
      "exp_month": null,
      "exp_year": null,
      "token_provider": null,
      "stamp_expdate": null,
      "token": null,
      "type": "credit_card"
    }
  },
  "links": {
    "receipt_url": "https://merchant.bepaid.by/customer/transactions/6a79932b-fedd-44dc-bdbc-5062d299a6c9/34beb20a341f81b9ce44f9d035e698b0c3a2a4c4d69f5a9ed4b2735b88051df0?language=en"
  },
  "version": 3,
  "gateway": {
    "iframe": true
  },
  "additional_data": {
    "customer_id_data": {
      "document_number": "AA123456"
    }
  },        
  "conversion": {
    "converted_amount": 10000,
    "converted_currency": "AMD",
    "exchange_rate": {
      "AMD_TO_AMD": 1.0
    },
    "exchange_rate_ids": [
      null
    ],
    "exchange_rate_date": "2026-10-19T13:25:46Z"
  },
  "transaction": {
    "auth_code": "32856845",
    "bank_code": null,
    "rrn": null,
    "ref_id": "261019137336380",
    "message": "Successful",
    "amount": 10000,
    "currency": "AMD",
    "billing_descriptor": null,
    "gateway_id": 6537,
    "status": "successful"
  }
}

P2P transfer

Send a POST request to https://gateway.bepaid.by/transactions/p2ps with the following parameters:
object
amount
required
 bigInteger
Transfer amount in minor currency units. For example, 32.45 must be sent as 3245.
currency
required
 string
Currency in ISO-4217 format, for example USD.
description
required
 string (255)
Transfer description.
tracking_id
required
 string (255)
Transaction identifier in the merchant's system.
notification_url
 string
URL to which notifications will be sent. The notification request format is the same as the transaction response format.
object
Sender's card parameters.
number
required
 string
Sender's card number.
exp_month
required
 string (2)
Sender's card expiration month, represented by one or two digits (for example, 01).
exp_year
required
 string (4)
Sender's card expiration year, represented by four digits (for example, 2028).
holder
required
 string (35)
Sender's cardholder name.
object
number
required
 string (19)
Card number.
holder
required
 string (32)
Cardholder name.
object
Sender details.
birth_date
required
 string
Sender's date of birth in ISO 8601 YYYY-MM-DD format.
object
Transfer recipient details.
first_name
required
 string (30)
Recipient's first name.
last_name
required
 string (30)
Recipient's last name.
object
Sender details.
first_name
required
 string (30)
Sender's first name.
last_name
required
 string (30)
Sender's last name.
country
required
 string
Sender's country in ISO 3166-1 alpha-2 format.
city
required
 string (60)
Sender's city.
state
 string
Sender's state or region. See more here.
zip
required
 string
Sender's postal code.
address
required
 string (255)
Sender's address.
object
Section containing additional transaction information.
object
Information about the sender's identification document.
document_type
 string (50)
Identification document type. Possible values are listed here.
document_number
required
 string (50)
Identification document number.
Request example 
{
    "request": {              
        "amount": 500,
        "currency": "BYN",              
        "description": "Test transaction p2ps ",
        "tracking_id": "tracking_id_01",
        "credit_card": {
            "number": "4012000000003010",
            "exp_month": "10",
            "exp_year": "2028",
            "holder": "JOHN DOE"
        },
        "sender_billing_address": {
            "first_name": "John",
            "last_name": "Doe",
            "country": "GB",
            "city": "London",
            "state": "Greater London",
            "zip": "SW1A 1AA",
            "address": "104 First Street"
        },
        "customer": {
          "birth_date": "1990-10-20" 
        },
        "recipient_card": {
            "number": "4012000000003101",
            "holder": "Alex Smith"
        },
        "recipient_billing_address": {
            "first_name": "Alex", 
            "last_name": "Smith" 
        },
        "additional_data": {
          "customer_id_data": {
            "document_number": "11111111"
          }
        }  
    }
}
Response example 
{
  "transaction": {
    "uid": "1848ft8f-df75-4b2f-af2a-ceaab1aba654",
    "status": "successful",
    "amount": 3391,
    "currency": "BYN",
    "description": "Order 202610201402541695cfdf4ee04a9e808e82",
    "type": "p2p",
    "payment_method_type": "credit_card",
    "tracking_id": "8262933984900016018",
    "message": "Transaction successful.",
    "test": false,
    "created_at": "2026-10-20T11:04:10.210Z",
    "updated_at": "2026-10-20T11:04:11.575Z",
    "paid_at": "2026-10-20T11:04:11.523Z",
    "language": "en",
    "redirect_url": "https://gateway.bepaid.by/process/1848ft8f-df75-4b2f-af2a-ceaab1aba654",
    "credit_card": {
      "holder": "",
      "product": "BMP",
      "exp_month": 4,
      "exp_year": 2031,
      "token_provider": null,
      "stamp_expdate": null,
      "token": null
    },
    "recipient_card": {
      "holder": "[FILTERED]",
      "stamp": "920dad6c0fd364d7d8285dcea7b93facb1a87fdc1ec09ea071c6d5f30591",
      "brand": "visa",
      "last_4": "3684",
      "first_1": "4",
      "bin": "424641",
      "bin_8": "42464100",
      "hash_bin9": "855d99ce946878712433ee8140140117ef8f116ebba245b04cb78cbf82160",
      "issuer_country": "BY",
      "issuer_name": "BANK",
      "product": "P",
      "exp_month": null,
      "exp_year": null,
      "token_provider": null,
      "stamp_expdate": null,
      "token": null
    },
    "receipt_url": "https://merchant.bepaid.by/customer/transactions/1848ft8f-df75-4b2f-af2a-ceaab1aba654/19effcf7e78ac4666aac22f8605c23f69a143270fac826a07b90c80e0d5a50d9?language=en",
    "recipient_billing_address": {
      "first_name": null,
      "last_name": null,
      "middle_name": null,
      "address": null,
      "country": null,
      "city": null,
      "zip": null,
      "state": null,
      "phone": null
    },
    "sender_billing_address": {
      "first_name": "[FILTERED]",
      "last_name": "[FILTERED]",
      "middle_name": null,
      "address": "[FILTERED]",
      "country": "RU",
      "city": "[FILTERED]",
      "zip": "[FILTERED]",
      "state": null,
      "phone": null
    },
    "status_code": null,
    "gateway": {
      "iframe": true
    },
    "version": 3,
    "three_ds_expired_at": null,
    "id": "1848ft8f-df75-4b2f-af2a-ceaab1aba654",
    "additional_data": {},    
    "code": "S.0000",
    "friendly_message": "Transaction successful.",
    "smart_routing_verification": {
      "status": "successful"
    },
    "verify_p2p": {
      "status": "successful",
      "message": "p2p is allowed",
      "amount": 3391,
      "currency": "BYN",
      "bank_fee": 0.27,
      "required_fields": null
    },
    "p2p": {
      "ref_id": "003537518950",
      "message": "The operation was successfully processed.",
      "amount": 3391,
      "currency": "BYN",
      "billing_descriptor": null,
      "gateway_id": 94890,
      "status": "successful",
      "auth_code": "678961",
      "rrn": "003537518950",
      "bank_code": "000"
    },
    "customer": {
      "ip": null,
      "email": null,
      "device_id": null,
      "birth_date": null,
      "external_id": null
    }
  }
}

Checking P2P transfer availability

Send a POST request to https://gateway.bepaid.by/p2p-restrictions with the following parameters:
object
amount
required
 bigInteger
Amount in minor currency units. For example, 32.45 must be sent as 3245.
currency
required
 string
Currency in ISO-4217 format, for example USD.
object
Sender's card parameters.
number
required
 string
Sender's card number.
exp_month
required
 string (2)
Sender's card expiration month, represented by one or two digits (for example, 01).
exp_year
required
 string (4)
Sender's card expiration year, represented by four digits (for example, 2028).
holder
required
 string (35)
Sender's cardholder name.
object
number
required
 string (19)
Card number.
holder
required
 string (32)
Cardholder name.
Request example 
{
    "request": {              
        "amount": 500,
        "currency": "BYN",            
        "credit_card": {
            "number": "4012000000003010",
            "exp_month": "10",
            "exp_year": "2028",
            "holder": "JOHN DOE"
        },              
        "recipient_card": {
            "number": "4012000000003101",
            "holder": "Alex Smith"
        }              
    }
}
Response example 
{
  "status": "successful",
  "message": "Successful",
  "commission": {
    "minimum": 0,
    "percent": 0.0,
    "bank_fee": 5.0,
    "currency": "BYN"
  },
  "code": "S.0000",
  "friendly_message": "Transaction successful."
}