Astropay Bank Transfer Withdrawal
Provider Astropay (now Directa24) offers bank transfer withdrawal for various countries in Latin America.
The following method IDs are covered in this section:
| ID | Name | Credit/Debit State |
|---|---|---|
| 265 | AstropayBankTransferWithdrawal | WithdrawnByProvider |
Payment method interaction type: Sychronous execution (see Interaction Types).
Payments are submitted to Directa24 - when being submitted successfully, the state is updated to InitiatedByProvider, else to WithdrawErrorReportedByProvider for an error or to RefusedByProvider for a rejected payment.
Submitted payments are sent by Astropay (D24) to the bank. Once they are confirmed by the bank, Astropay sends a notification to PXP Financial. PXP Financial queries the Astropay (D24) system for the status of the payment and update the payment state on PXP Financial side.
Redirect Integration
Currently not supported.
Backend2BackendIntegration
The following table contains the fields to be sent in the initiatePaymentRequest.specificPaymentAccountData xml section:
| key (value type, account type, required) | value |
|---|---|
| CurrencyCode (string) | currency code, e.g. BRL |
| BankCountryCode2 (string) | country code, e.g. BR |
| AccountNumber (string) | Bank account number |
| BranchCode (string) | bank branch code |
| BankSortCode (string) | Bank code |
| AccountOwnerAddress (string) | Address of bank account owner |
| AccountOwner (string) | Account owner name |
| AccountType (string) | Account type value (see below) |
The following parameters can be provided in initiatePaymentRequest.specificPaymentData:
| key (value type, account type, required) | value |
|---|---|
| PaymentProviderID (Int) | Provider ID - default value 152 |
| UserFirstName (string) | Beneficiary´s first name |
| UserLastName (string) | Beneficiary´s last name |
The following parameters have to passed in initiatePaymentRequest.UserData:
| key (value type, account type, required) | value |
|---|---|
| identificationNumber (string) | identification number |
| identificationNumberType (string) | identification number type |
Overview of required parameters:
| Field | Argentina | Brazil | Chile | Columbia | Mexico | Peru | Uruguay |
|---|---|---|---|---|---|---|---|
| BankSortCode | NA | Mandatory (see validations); send either the bank code or the ISPB | Mandatory | Mandatory (see validations) | mandatory only if bank account length is 16 (debit card) | NA | Mandatory (see validations) |
| BranchCode | NA | Mandatory (see validations) | NA | NA | NA | NA | Mandatory (see validations) |
| AccountNumber | Mandatory (CBU) (see validations) | Mandatory (see validations) | Mandatory | Mndatory | Mandatory (Clabe or Debit card; see validations) | Mandatory (CCI) (see validations) | Mandatory (see validations) |
| AccountType | NA | Mandatory (see validations) | Mandatory (see validations) | Mandatory (see validations) | NA | Mandatory (see validations) | mandatory (only if bank sort code is BROU) |
| UserFirstName | Mandatory | Mandatory | Mandatory | Mandatory | Mandotry | Mandatory | Mandatory |
| UserLastName | NA (optional) | Mandatory | Mandatory | Mandatory | Mandatory | Mandatory | Mandatory |
| IdentificationNumber | Mandatory (see validations) | Mandatory (see validations) | Mandatory (see validations) | Mandatory (see validations) | Mandatory (see validations) | Mandatory (see validations) | |
| IdentificationNumberType | NA (optional) | NA (optional) | NA (optional) | Mandatory (see validations) | NA | ||
| currency | ARS | BRL | CLP | COP | MXN | PEN | UYU |
| Street (in User) | NA (optional) | NA (optional) | NA (optional) | Mandatory | NA (optional) | NA (optional) | NA (optional) |
| eMail (in User) | NA (optional) | NA (optional) | NA (optional) | mandatory | NA (optional) | NA (optional) | NA (optional) |
Data Validation
Account Type for Brazil
The AccountType value for Brazil is mandatory. The following values apply:
'1' - For Individual Savings Account - account type 'S' is sent to Astropay
'2'- For Corporate Savings Account - account type 'S' is sent to Astropay
'3' - For Individual Checking Account - account type 'C' is sent to Astropay
'4' - For Corporate Checking Account - account type 'C' is sent to AstropayAlternatively the values 'C' or 'S' can be passed in the field AccountType for Astropay.
AccountType for other countries
- Chile: C for checking account, S for savings account and V for vista
- Columbia: C for checking and S for savings; for Efecty please send accountType S
- Peru: M (Cuenta Maestra)
Identification Number Validation
- Brazil:
- CPF: Length 11; validate verifier-digits
- CNPJ : Length between 12 and 14; validate verifier-digitals
- Chile: ID / RUN / RUT: Length 8 or 9
- Colombia:
- CC: Numeric. Length between 6 and 10 inclusive
- NIT: Numeric. Length between 8 and 15
- CE: Numeric. Length lower than 6 and 10 inclusive
- PASS: Length between 6 and 10 inclusive
*CE (for PEP): Numeric. Length 15.- Peru:
- DNI: length between 8 and 9
- RUC: length 11
- CE (Carnet Extranjeria): Numeric. Lenght 9
- PASS (Passport): length 12
- Mexico: CURP /RFC / IFE / PASS / Residencia: Length between 8 and 18 inclusive
- Argentina:
- DNI: Numeric, Length 7-9
- CUIT/CUIL: Numeric, Length between 7 and 9 inclusive or equal to 11
- Uruguay:
- CI: Numeric. Length between 9 and 13 inclusive
Postal Code validations:
| Country | Regex | Example |
|---|---|---|
| Argentina | ^\d{4}|[A-Za-z]\d{4}([a-zA-Z]{3})?$ | A1234ABC |
| Brazil | ^\d{5}[\s-/]?\d{3}$ | 12345-678 |
| Chile | ^\d{3}[\s-/]?\d{4}$ | 123-4567 |
| Columbia | ^\d{5,6}$ | 12345 |
| Mexico | ^\d{5}$ | 12345 |
| Peru | ^\d{5}$ | 12345 |
| Uruguay | ^\d{5}$ | 12345 |
Bank codes:
Code Bank name
001 Banco de Chile
016 Banco Credito e Inversiones
053 Banco Ripley
052 Deutsche Bank
054 Radobank Chile
027 Corpbanca
028 Banco Bice
049 Banco Security
031 HSBC Bank
046 ABN Amor Bank Chile
037 Banco Santander- Santiago
057 Banco Paris
507 Banco del Desarrollo
014 Scotiabank Sud Americano
056 Banco Penta
055 Consorcio
012 Banco del Estado de Chile
009 Banco Internacional
039 Banco Itau
051 Banco Falabella
504 BBVA Banco Bhif
Code Bank name
003 Interbank
800 Caja Metropolitana de Lima
805 Caja Municipal de Ahorro y Crédito Sullana
801 Caja Municipal de Ahorro y Crédito Piura SAC
011 BBVA Continental
002 Banco de Crédito del Perú
808 Caja Municipal de Ahorro y Crédito Huancayo
806 Caja Municipal de Ahorro y Crédito Cuzco
803 Caja Municipal de Ahorro y Crédito Arequipa
802 Caja Municipal de Ahorro y Crédito Trujillo
007 Citibank
054 Banco Falabella
053 Banco GNB Perú S.A.
049 Mi Banco
043 Crediscotia Financiera
038 Banco Interamericano de Finanzas (BIF)
035 Banco Financiero
023 Banco de Comercio
018 Banco de la Nación
009 Scotiabank
056 Santander
Code Bank name
615 MERRILL LYNCH
623 SKANDIA
622 OACTIN
616 FINAMEX
617 VALMEX
620 PROFUTURO
619 MAPFRE
621 CB ACTINVER
618 UNICA
614 ACCIVAL
140 CONSUBANCO
141 VOLKSWAGEN
143 CIBANCO
166 BANSEFI
168 HIPOTECARIA FEDERAL
145 BBASE
600 MONEXCB
601 GBM
602 MASARI
605 VALUE
606 ESTRUCTURADORES
607 TIBER
608 VECTOR
610 B&B
139 UBS BANK
634 FINCOMUN
646 STP
647 TELECOMM
648 EVERCORE
649 SKANDIA
651 SEGMTY
653 KUSPIT
655 SOFIEXPRESS
656 UNAGRA
659 OPCIONES EMPRESARIALES DEL NOROESTE
670 LIBERTAD
901 CLS
642 REFORMA
640 CB JPMORGAN
638 AKALA
626 CBDEUTSCHE
627 ZURICH
628 ZURICHVI
652 ASEA
629 SU CASITA
630 CB INTERCAM
631 CI BOLSA
632 BULLTICK CB
633 STERLING
636 HDI SEGUROS
637 ORDER
902 INDEVAL
9 BANOBRAS
42 MIFEL
44 SCOTIABANK
58 BANREGIO
59 INVEX
60 BANSI
62 AFIRME
72 BANORTE
102 THE ROYAL BANK
37 INTERACCIONES
36 INBURSA
2 BANAMEX
12 BBVA BANCOMER
14 SANTANDER
19 BANJERCITO
21 HSBC
30 BAJIO
32 IXE
6 BANCOMEXT
103 AMERICAN EXPRESS
106 BAMSA
128 AUTOFIN
129 BARCLAYS
130 COMPARTAMOS
131 BANCO FAMSA
132 BMULTIVA
133 ACTINVER
134 WALMART
135 NAFIN
136 INTERBANCO
137 BANCOPPEL
138 ABC CAPITAL
127 AZTECA
124 DEUTSCHE
108 TOKYO
126 CREDIT SUISSE
110 JP MORGAN
112 BMONEX
113 VE POR MAS
116 ING
001 BANCO DE BOGOTÁ
002 BANCO POPULAR
006 ITAÚ - Antes CORPBANCA
007 BANCOLOMBIA
008 ABN AMRO
009 CITIBANK
010 HSBC
012 BANCO SUDAMERIS
013 BBVA
014 ITAÚ (HELM)
019 BANCO COLPATRIA
023 BANCO DE OCCIDENTE
032 BANCO CAJA SOCIAL BCSC
040 BANCO AGRARIO
051 BANCO DAVIVIENDA
052 BANCO AV VILLAS
058 BANCO PROCREDIT
060 ANCO PICHINCHA
061 BANCOOMEVA
062 BANCO FALABELLA S.A
065 SANTANDER
076 COOPCENTRAL S.A
283 COOPERATIVA FINANCIERA DE ANTIOQUIA
289 COTRAFA COOPERATIVA FINANCIERA
292 CONFIAR
296 FINANCIERA JURISCOOP
1507 NEQUI
1551 DAVIPLATA
Notice that the bank code is not mandatory for Argentina.
Bank name Code
A.B.N Amro Bank 005
American Express Bank Ltd 295
Bacs Banco de Credito Y Securitizacion 340
Banca Nazionale Del Lavoro 265
Banco B. I. Creditanstalt 147
Banco Banex 297
Banco Bradesco Argentina 336
Banco Cetelem Argentina 331
Banco CMF 319
Banco Cofidis 335
Banco Columbia 389
Banco Comafi 299
Banco Credicoop Coop. L 191
Banco de Corrientes 094
Banco de Formosa 315
Banco de Galicia Y Buenos Aires 007
Banco de Inversion Y Comercio Exterior 300
Banco de La Ciudad de Buenos Aires 029
Banco de La Nacion Argentina 011
Banco de La Pampa Sociedad de Economia M 093
Banco de La Provincia de Buenos A 014
Banco de La Provincia de Cordoba 020
Banco de La Republica Oriental Del Uruguay 269
Banco de San Juan 045
Banco de Santa Cruz 086
Banco de Santiago Del Estero 321
Banco de Servicios Financieros 332
Banco de Servicios Y Transacciones 338
Banco de Valores 198
Banco Del Chubut 083
Banco Del Sol 310
Banco Del Tucuman 060
Banco Do Brasil 046
Banco Empresario de Tucuman Coop. L 137
Banco Finansur 303
Banco Hipotecario 044
Banco Itau Buen Ayre 259
Banco Julio 305
Banco Macro Bansud 285
Banco Mariva 254
Banco Mercurio 293
Banco Meridian 281
Banco Municipal de Ros 065
Banco Patagonia Sudameris 034
Banco Piano 301
Banco Privado de Inversiones 306
Banco Provincia de Tierra Del Fuego 268
Banco Provincia Del Neuquen 097
Banco Regional de Cuyo 079
Banco Rio de La Plata 072
Banco Roela 247
Banco Saenz 277
Banco Societe Generale 027
Bank Of America, National Associa 262
Bankboston, National Associa 015
BBVA Banco Frances 017
Bnp Paribas 266
Citibank 016
Deutsche Bank 325
HSBC Bank Argentina 150
Ing Bank 294
J P Morgan Chase Bank Sucursal Buenos Aires 165
Lloyds Tsb Bank 010
M. B. A. Banco de Inversiones 312
Nuevo Banco Bisel 388
Nuevo Banco de Entre Rios 386
Nuevo Banco de La Rioja 309
Nuevo Banco de Santa Fe 330
Nuevo Banco Del Chaco 311
Nuevo Banco Industrial de Azul 322
Nuevo Banco Suquia 387
Rci Ba 339
The Bank Of Tokyo - Mitsubishi 018
Bank Code
BANCO ABN AMRO S.A. 075
Cooperativa Central de Crédito Urbano-CECRED 085
BANCO DA AMAZONIA S.A. 003
BANCO DO NORDESTE DO BRASIL S.A. 004
BANCO BONSUCESSO S.A. 218
BANCO BRADESCO S.A. 237
BANCO DO BRASIL S.A. 001
BANCO DE BRASILIA S.A. - BRB 070
CAIXA ECONOMICA FEDERAL - CEF 104
CITIBANK N.A. 477
BANCO COOPERATIVO DO BRASIL S/A - BANCOOB 756
BANCO DAYCOVAL S.A. 707
BANESTES S.A. BANCO DO ESTADO DO ESPIRITO SANTO 021
BANCO DO ESTADO DO PARA S.A. - BANPARA 037
BANCO DO ESTADO DO RIO GRANDE DO SUL S.A. - BANRISUL 041
BANCO DO ESTADO DE SERGIPE S.A. - BANESE 047
HSBC BANK BRASIL S.A. - BANCO MULTIPLO 399
ITAU UNIBANCO S.A. 341
BANCO MERCANTIL DO BRASIL S.A. 389
BANCO MODAL S.A. 746
BANCO SAFRA S.A. 422
BANCO SANTANDER BRASIL S.A. 033
BANCO COOPERATIVO SICREDI S.A. 748
BANCO INTER 077
BANCO SOFISA 637
BANCO NEON 735
NU PAGAMENTOS 260
Cooperativa Central de Crédito Urbano-CECRED 085
BANCO AGIPLAN S.A. 121
Confederação Nacional das Cooperativas Centrais Unicred 136
BANCO ORIGINAL 212
Banco Votorantim S.A. 655
BANCO CITIBANK 745
PagSeguro Internet S.A. 290
BANCO BMG S.A 318
BANCO C6 S.A. 336
Bank account validations Columbia
| BankName | Bank Code | Format | Regex | Example |
|---|---|---|---|---|
| Nequi | 1507 | Customer´s mobile phone | ^[\s\S]{1,20}$ | 1234567890 |
| Daviplata | 1551 | Customer´s mobile phone | ^[\s\S]{1,20}$ | |
| Efecty | 10003 | |||
| Others | - | Numeric | ^\d{8,19}$ | 1234567890123 |
Branch code (Brazil):
| Bank | Format | Example |
|---|---|---|
| ABN Amro | Format: XXXX where X are digits. The number of digits can't exceed 5 | 1234 |
| Banco do Brasil | Not permitted values: 001, 051. Format: XXXX-D or XXXXD where X are digits and D are digits or a 'X'. The number of digits may change, but can't exceed 5 digits | 12345, 1234-5, 1234-X, 1234X |
| Santander | Not permitted values: 033. Format: XXXX-X or XXXXX where X are digits. The number of digits may change, but can't exceed 5 digits | 12345, 1234-5 |
| Itau | Not permitted values: 001, 341, 500. Format: XXXX-X or XXXXX where X are digits. The number of digits may change, but can't exceed 5 digits | 12345, 1234-5 |
| Caixa | Not permitted values: 013, 023, 104. Format: XXXX-X or XXXXX where X are digits. The number of digits may change, but can't exceed 5 digits | 12345, 1234-5 |
| Bradesco | Not permitted values: 237. Format: XXXX-X or XXXXX where X are digits. The number of digits may change, but can't exceed 5 digits | 12345, 1234-5 |
| Others | Format: XXXX-X or XXXXX where X are digits. The number of digits may change, but can't exceed 5 digits | 12345, 1234-5 |
Requests/Responses
Example initiatePaymentRequest:
<?xml version="1.0" encoding="utf-8"?>
<initiatePaymentRequest xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns="http://www.cqrpayments.com/PaymentProcessing">
<merchantID>B2BTestMerchant</merchantID>
<shopID>AstropayCardBankTransferWithdrawalShop</shopID>
<merchantTransactionID>5f366a56-a394-4ab2-aac3-f4174ba716d8-21</merchantTransactionID>
<paymentMethodID>265</paymentMethodID>
<amount currencyCode="BRL">10.01</amount>
<userID>12eadca3-0d87-4144-a75e-10ea70</userID>
<userData>
<username>061bb617-bbe8-4aa4-b896-8b06949e653b</username>
<firstname>Edson</firstname>
<lastname>Arantes do Nascimento</lastname>
<currencyCode xsi:nil="true" />
<languageCode xsi:nil="true" />
<email xsi:nil="true" />
<address>
<street>Street</street>
<houseName xsi:nil="true" />
<houseNumber>1</houseNumber>
<houseNumberExtension xsi:nil="true" />
<postalCode>11300</postalCode>
<city>Sao Paulo</city>
<state xsi:nil="true" />
<countryCode2>BR</countryCode2>
<telephoneNumber>099123456</telephoneNumber>
</address>
<dateOfBirth>1955-02-15T00:00:00</dateOfBirth>
<identificationNumber>1234567890</identificationNumber>
<identificationNumberType>1</identificationNumberType>
</userData>
<userIP>127.0.0.1</userIP>
<userSessionID>a59a22cd-6178-4125-b966-188ff1a61181</userSessionID>
<creationTypeID>1</creationTypeID>
<specificPaymentData>
<data xsi:type="keyStringValuePair">
<key>UserFirstname</key>
<value>John</value>
</data>
<data xsi:type="keyStringValuePair">
<key>UserLastname</key>
<value>Doe</value>
</data>
<data xsi:type="keyIntValuePair">
<key>PaymentProviderID</key>
<value>152</value>
</data>
</specificPaymentData>
<paymentAccount>
<specificPaymentAccountData>
<data xsi:type="keyStringValuePair">
<key>CurrencyCode</key>
<value>BRL</value>
</data>
<data xsi:type="keyStringValuePair">
<key>BankCountryCode2</key>
<value>BR</value>
</data>
<data xsi:type="keyStringValuePair">
<key>AccountNumber</key>
<value>88365484</value>
</data>
<data xsi:type="keyStringValuePair">
<key>BranchCode</key>
<value>7197</value>
</data>
<data xsi:type="keyStringValuePair">
<key>AccountOwner</key>
<value>Edson Arantes do Nascimento</value>
</data>
<data xsi:type="keyStringValuePair">
<key>BankSortCode</key>
<value>033</value>
</data>
<data xsi:type="keyStringValuePair">
<key>AccountOwnerAddress</key>
<value>1225 Bonavita St.</value>
</data>
<data xsi:type="keyStringValuePair">
<key>AccountType</key>
<value>1</value>
</data>
</specificPaymentAccountData>
</paymentAccount>
</initiatePaymentRequest>
<initiatePaymentRequest xmlns="http://www.cqrpayments.com/PaymentProcessing"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<merchantID>YourShop</merchantID>
<shopID>YourMerchant</shopID>
<merchantTransactionID>59715590-9</merchantTransactionID>
<paymentMethodID>265</paymentMethodID>
<amount currencyCode="MXN">1.00</amount>
<userID>ygtest</userID>
<userData>
<username>ygtest</username>
<firstname>John</firstname>
<lastname>Doe</lastname>
<email>[email protected]</email>
<address>
<countryCode2>MX</countryCode2>
</address>
<dateOfBirth>1955-02-15T00:00:00</dateOfBirth>
</userData>
<userIP>179.108.166.2</userIP>
<userSessionID>59715590</userSessionID>
<creationTypeID>1</creationTypeID>
<specificPaymentData>
<data xsi:type="keyIntValuePair">
<key>PaymentProviderID</key>
<value>152</value>
</data>
</specificPaymentData>
<paymentAccount>
<specificPaymentAccountData>
<data xsi:type="keyStringValuePair">
<key>BankName</key>
<value>Banco do Brasil</value>
</data>
<data xsi:type="keyStringValuePair">
<key>BankCountryCode2</key>
<value>MX</value>
</data>
<data xsi:type="keyStringValuePair">
<key>AccountNumber</key>
<value>032180000118359719</value>
</data>
<data xsi:type="keyStringValuePair">
<key>AccountOwner</key>
<value>DOS SANTOS</value>
</data>
<data xsi:type="keyStringValuePair">
<key>BankSortCode</key>
<value>032</value>
</data>
</specificPaymentAccountData>
</paymentAccount>
</initiatePaymentRequest>
<initiatePaymentRequest xmlns="http://www.cqrpayments.com/PaymentProcessing"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<merchantID>YourMerchant</merchantID>
<shopID>YourShop</shopID>
<merchantTransactionID>59715590-11-27</merchantTransactionID>
<paymentMethodID>265</paymentMethodID>
<amount currencyCode="PEN">100.00</amount>
<userID>ygtest_SBCOM_BRL</userID>
<userData>
<username>ygtest_SBCOM_BRL</username>
<firstname>Yusuf</firstname>
<lastname>Genc</lastname>
<email>[email protected]</email>
<address>
<countryCode2>PE</countryCode2>
</address>
<dateOfBirth>1955-02-15T00:00:00</dateOfBirth>
<identificationNumber>58324956</identificationNumber>
<identificationNumberType>DNI</identificationNumberType>
</userData>
<userIP>179.108.166.2</userIP>
<userSessionID>59715590</userSessionID>
<creationTypeID>1</creationTypeID>
<specificPaymentData>
<data xsi:type="keyIntValuePair">
<key>PaymentProviderID</key>
<value>152</value>
</data>
</specificPaymentData>
<paymentAccount>
<specificPaymentAccountData>
<data xsi:type="keyStringValuePair">
<key>BankName</key>
<value>Banco do Peru</value>
</data>
<data xsi:type="keyStringValuePair">
<key>BankCountryCode2</key>
<value>PE</value>
</data>
<data xsi:type="keyStringValuePair">
<key>AccountNumber</key>
<value>00159687395013948567</value>
</data>
<data xsi:type="keyStringValuePair">
<key>AccountOwner</key>
<value>DOS SANTOS</value>
</data>
<data xsi:type="keyStringValuePair">
<key>BankSortCode</key>
<value>113</value>
</data>
<data xsi:type="keyStringValuePair">
<key>AccountType</key>
<value>C</value>
</data>
</specificPaymentAccountData>
</paymentAccount>
</initiatePaymentRequest>
<initiatePaymentRequest xmlns="http://www.cqrpayments.com/PaymentProcessing"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<merchantID>PG</merchantID>
<shopID>releaseb</shopID>
<merchantTransactionID>59715590-11-42</merchantTransactionID>
<paymentMethodID>265</paymentMethodID>
<amount currencyCode="PEN">100.00</amount>
<userID>ygtest_SBCOM_BRL</userID>
<userData>
<username>ygtest_SBCOM_BRL</username>
<firstname>Yusuf</firstname>
<lastname>Genc</lastname>
<email>[email protected]</email>
<address>
<countryCode2>PE</countryCode2>
</address>
<dateOfBirth>1955-02-15T00:00:00</dateOfBirth>
<identificationNumber>10583249562</identificationNumber>
<identificationNumberType>RUC</identificationNumberType>
</userData>
<userIP>179.108.166.2</userIP>
<userSessionID>59715590</userSessionID>
<creationTypeID>1</creationTypeID>
<specificPaymentData>
<data xsi:type="keyIntValuePair">
<key>PaymentProviderID</key>
<value>152</value>
</data>
</specificPaymentData>
<paymentAccount>
<specificPaymentAccountData>
<data xsi:type="keyStringValuePair">
<key>BankName</key>
<value>Banco do Peru</value>
</data>
<data xsi:type="keyStringValuePair">
<key>BankCountryCode2</key>
<value>PE</value>
</data>
<data xsi:type="keyStringValuePair">
<key>AccountNumber</key>
<value>00159687395013948567</value>
</data>
<data xsi:type="keyStringValuePair">
<key>AccountOwner</key>
<value>DOS SANTOS</value>
</data>
<data xsi:type="keyStringValuePair">
<key>BankSortCode</key>
<value>113</value>
</data>
<data xsi:type="keyStringValuePair">
<key>AccountType</key>
<value>C</value>
</data>
</specificPaymentAccountData>
</paymentAccount>
</initiatePaymentRequest>
<initiatePaymentRequest xmlns="http://www.cqrpayments.com/PaymentProcessing"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<merchantID>PG</merchantID>
<shopID>releaseb</shopID>
<merchantTransactionID>59715590-1-06</merchantTransactionID>
<paymentMethodID>265</paymentMethodID>
<amount currencyCode="CLP">1.00</amount>
<userID>ygtest_SBCOM_BRL</userID>
<userData>
<username>ygtest_SBCOM_BRL</username>
<firstname>Max</firstname>
<lastname>Muster</lastname>
<email>[email protected]</email>
<address>
<countryCode2>CL</countryCode2>
</address>
<dateOfBirth>1955-02-15T00:00:00</dateOfBirth>
<identificationNumber>21644285</identificationNumber>
</userData>
<userIP>179.108.166.2</userIP>
<userSessionID>59715590</userSessionID>
<creationTypeID>1</creationTypeID>
<specificPaymentData>
<data xsi:type="keyIntValuePair">
<key>PaymentProviderID</key>
<value>152</value>
</data>
</specificPaymentData>
<paymentAccount>
<specificPaymentAccountData>
<data xsi:type="keyStringValuePair">
<key>BankName</key>
<value>Banco de Chile</value>
</data>
<data xsi:type="keyStringValuePair">
<key>BankCountryCode2</key>
<value>CL</value>
</data>
<data xsi:type="keyStringValuePair">
<key>AccountNumber</key>
<value>9795493</value>
</data>
<data xsi:type="keyStringValuePair">
<key>AccountOwner</key>
<value>DOS SANTOS</value>
</data>
<data xsi:type="keyStringValuePair">
<key>BankSortCode</key>
<value>001</value>
</data>
<data xsi:type="keyStringValuePair">
<key>AccountType</key>
<value>C</value>
</data>
</specificPaymentAccountData>
</paymentAccount>
</initiatePaymentRequest>
<initiatePaymentRequest xmlns="http://www.cqrpayments.com/PaymentProcessing"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<merchantID>PG</merchantID>
<shopID>releaseb</shopID>
<merchantTransactionID>59715590-12-11-313</merchantTransactionID>
<paymentMethodID>265</paymentMethodID>
<amount currencyCode="COP">1000</amount>
<userID>ygtest_SBCOM_BRL</userID>
<userData>
<username>ygtest_SBCOM_BRL</username>
<firstname>Yusuf</firstname>
<lastname>Genc</lastname>
<email>[email protected]</email>
<address>
<countryCode2>CO</countryCode2>
</address>
<dateOfBirth>1955-02-15T00:00:00</dateOfBirth>
<identificationNumber>1058324956</identificationNumber>
<identificationNumberType>CC</identificationNumberType>
</userData>
<userIP>179.108.166.2</userIP>
<userSessionID>59715590</userSessionID>
<creationTypeID>1</creationTypeID>
<specificPaymentData>
<data xsi:type="keyIntValuePair">
<key>PaymentProviderID</key>
<value>152</value>
</data>
</specificPaymentData>
<paymentAccount>
<specificPaymentAccountData>
<data xsi:type="keyStringValuePair">
<key>BankName</key>
<value>Banco de Bogota</value>
</data>
<data xsi:type="keyStringValuePair">
<key>BankCountryCode2</key>
<value>CO</value>
</data>
<data xsi:type="keyStringValuePair">
<key>AccountNumber</key>
<value>0321800001183597</value>
</data>
<data xsi:type="keyStringValuePair">
<key>AccountOwner</key>
<value>DOS SANTOS</value>
</data>
<data xsi:type="keyStringValuePair">
<key>BankSortCode</key>
<value>001</value>
</data>
</specificPaymentAccountData>
</paymentAccount>
</initiatePaymentRequest>
<initiatePaymentRequest xmlns="http://www.cqrpayments.com/PaymentProcessing"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<merchantID>DemoMerchant</merchantID>
<shopID>DemoShop</shopID>
<merchantTransactionID>hctest002013514</merchantTransactionID>
<paymentMethodID>265</paymentMethodID>
<amount currencyCode="COP">40000</amount>
<userID>55517534-03</userID>
<userData>
<username>pp_ppboleto7-03</username>
<firstname>PPPPBOLETOFN</firstname>
<lastname>PPPPBOLETOLN</lastname>
<email>[email protected]</email>
<address>
<street>Address</street>
<houseName>Address</houseName>
<postalCode>447475</postalCode>
<state>State</state>
<countryCode2>CO</countryCode2>
<telephoneNumber>+573104028587</telephoneNumber>
</address>
<dateOfBirth>1940-03-08T00:00:00</dateOfBirth>
<identificationNumber>2134567890</identificationNumber>
<identificationNumberType>CC</identificationNumberType>
</userData>
<userIP>10.8.60.57</userIP>
<userSessionID>53603061</userSessionID>
<creationTypeID>1</creationTypeID>
<specificPaymentData>
<data xsi:type="keyStringValuePair">
<key>UserFirstname</key>
<value>PPPPBOLETOFN</value>
</data>
<data xsi:type="keyStringValuePair">
<key>UserLastname</key>
<value>PPPPBOLETOLN</value>
</data>
<data xsi:type="keyStringValuePair">
<key>UserCountryCode2</key>
<value>CO</value>
</data>
<data xsi:type="keyIntValuePair">
<key>PaymentProviderID</key>
<value>152</value>
</data>
</specificPaymentData>
<paymentAccount>
<specificPaymentAccountData>
<data xsi:type="keyStringValuePair">
<key>CurrencyCode</key>
<value>COP</value>
</data>
<data xsi:type="keyStringValuePair">
<key>BankCountryCode2</key>
<value>CO</value>
</data>
<data xsi:type="keyStringValuePair">
<key>BankSortCode</key>
<value>10003</value>
</data>
<data xsi:type="keyStringValuePair">
<key>AccountType</key>
<value>S</value>
</data>
</specificPaymentAccountData>
</paymentAccount>
</initiatePaymentRequest>
Example initiatePaymentResponse:
<initiatePaymentResponse xmlns="http://www.cqrpayments.com/PaymentProcessing" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<payment xsi:type="paymentWithPaymentAccount">
<merchantID>B2BTestMerchant</merchantID>
<shopID>AstropayCardBankTransferWithdrawalShop</shopID>
<paymentMethod>
<key>265</key>
<value>AstropayBankTransferWithdrawal</value>
</paymentMethod>
<merchantTransactionID>5f366a56-a394-4ab2-aac3-f4174ba716d8-21</merchantTransactionID>
<paymentID>cf976b7d-3711-441d-b38a-5f8c6a6becd1</paymentID>
<userID>12eadca3-0d87-4144-a75e-10ea70</userID>
<paymentProvider>
<key>152</key>
<value>Astropay</value>
</paymentProvider>
<amount currencyCode="BRL">10.01</amount>
<creationType>
<key>1</key>
<value>User</value>
</creationType>
<userIP>127.0.0.1</userIP>
<state>
<id>60425692-feae-47bb-b699-7b4ae6081c23</id>
<definition>
<key>3</key>
<value>InitiatedByProvider</value>
</definition>
<createdOn>2017-11-09T08:43:33.7735125Z</createdOn>
<description>OK</description>
<paymentStateDetails>
<detail xsi:type="keyStringValuePair">
<key>ProviderResponseMessage</key>
<value>OK</value>
</detail>
<detail xsi:type="keyStringValuePair">
<key>PaymentStateReasonID</key>
<value>1</value>
</detail>
</paymentStateDetails>
</state>
<isExecuted>false</isExecuted>
<baseAmount currencyCode="EUR">2.66</baseAmount>
<paymentDetails>
<detail xsi:type="keyStringValuePair">
<key>UserFirstname</key>
<value>John</value>
</detail>
<detail xsi:type="keyStringValuePair">
<key>UserLastname</key>
<value>Doe</value>
</detail>
<detail xsi:type="keyStringValuePair">
<key>ProviderExternalID</key>
<value>cf976b7d-3711-441d-b38a-5f8c6a6becd1</value>
</detail>
<detail xsi:type="keyStringValuePair">
<key>ProviderTransactionID</key>
<value>e9d14450-20db-4304-b55d-a652953f7976</value>
</detail>
</paymentDetails>
<paymentAccount>
<paymentAccountID>541885ca-1f5b-4f16-be70-62cd9cb973a5</paymentAccountID>
</paymentAccount>
</payment>
</initiatePaymentResponse>
<initiatePaymentResponse xmlns="http://www.cqrpayments.com/PaymentProcessing" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<payment xsi:type="paymentWithPaymentAccount">
<merchantID>YourMerchant</merchantID>
<shopID>YourShop</shopID>
<paymentMethod>
<key>265</key>
<value>AstropayBankTransferWithdrawal</value>
</paymentMethod>
<merchantTransactionID>59715590-9</merchantTransactionID>
<paymentID>f9b6a33c-831e-4f37-b533-3fc6f6db70da</paymentID>
<userID>ygtest</userID>
<paymentProvider>
<key>152</key>
<value>Astropay</value>
</paymentProvider>
<amount currencyCode="MXN">1.00</amount>
<creationType>
<key>1</key>
<value>User</value>
</creationType>
<userIP>179.108.166.2</userIP>
<state>
<id>cefcf293-2583-4962-9720-50de184fd70f</id>
<definition>
<key>3</key>
<value>InitiatedByProvider</value>
</definition>
<createdOn>2018-02-01T15:34:48.2705465Z</createdOn>
<paymentStateDetails>
<detail xsi:type="keyStringValuePair">
<key>ProviderResponseMessage</key>
<value>OK</value>
</detail>
<detail xsi:type="keyStringValuePair">
<key>PaymentStateReasonID</key>
<value>1</value>
</detail>
</paymentStateDetails>
</state>
<isExecuted>false</isExecuted>
<baseAmount currencyCode="EUR">0.06</baseAmount>
<paymentDetails>
<detail xsi:type="keyStringValuePair">
<key>ProviderExternalID</key>
<value>2257</value>
</detail>
<detail xsi:type="keyStringValuePair">
<key>ProviderTransactionID</key>
<value>25161</value>
</detail>
</paymentDetails>
<paymentAccount>
<paymentAccountID>e67a3016-a5cb-4986-8210-1d39a68d5943</paymentAccountID>
</paymentAccount>
</payment>
</initiatePaymentResponse>
<initiatePaymentResponse xmlns="http://www.cqrpayments.com/PaymentProcessing" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<payment xsi:type="paymentWithPaymentAccount">
<merchantID>YourMerchant</merchantID>
<shopID>YourShop</shopID>
<paymentMethod>
<key>265</key>
<value>AstropayBankTransferWithdrawal</value>
</paymentMethod>
<merchantTransactionID>59715590-11-27</merchantTransactionID>
<paymentID>d3f26f44-e30e-4741-a819-853e97be0dfa</paymentID>
<userID>ygtest_SBCOM_BRL</userID>
<paymentProvider>
<key>152</key>
<value>Astropay</value>
</paymentProvider>
<amount currencyCode="PEN">100.00</amount>
<creationType>
<key>1</key>
<value>User</value>
</creationType>
<userIP>179.108.166.2</userIP>
<state>
<id>bd938504-0c97-486b-a9e2-bfe91a3784c4</id>
<definition>
<key>3</key>
<value>InitiatedByProvider</value>
</definition>
<createdOn>2018-02-02T14:53:55.7424819Z</createdOn>
<paymentStateDetails>
<detail xsi:type="keyStringValuePair">
<key>ProviderResponseMessage</key>
<value>OK</value>
</detail>
<detail xsi:type="keyStringValuePair">
<key>PaymentStateReasonID</key>
<value>1</value>
</detail>
</paymentStateDetails>
</state>
<isExecuted>false</isExecuted>
<baseAmount currencyCode="EUR">24.94</baseAmount>
<paymentDetails>
<detail xsi:type="keyStringValuePair">
<key>ProviderExternalID</key>
<value>2281</value>
</detail>
<detail xsi:type="keyStringValuePair">
<key>ProviderTransactionID</key>
<value>25185</value>
</detail>
</paymentDetails>
<paymentAccount>
<paymentAccountID>70a5c7a8-76da-4503-937d-faf0a331bccd</paymentAccountID>
</paymentAccount>
</payment>
</initiatePaymentResponse>
<initiatePaymentResponse xmlns="http://www.cqrpayments.com/PaymentProcessing" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<payment xsi:type="paymentWithPaymentAccount">
<merchantID>YourMerchamt</merchantID>
<shopID>YourShop</shopID>
<paymentMethod>
<key>265</key>
<value>AstropayBankTransferWithdrawal</value>
</paymentMethod>
<merchantTransactionID>59715590-11-42</merchantTransactionID>
<paymentID>98858d51-cc27-49e1-a036-505bf89f137f</paymentID>
<userID>ygtest_SBCOM_BRL</userID>
<paymentProvider>
<key>152</key>
<value>Astropay</value>
</paymentProvider>
<amount currencyCode="PEN">100.00</amount>
<creationType>
<key>1</key>
<value>User</value>
</creationType>
<userIP>179.108.166.2</userIP>
<state>
<id>9122d0e4-b161-4474-934b-bc3ebbfa29ff</id>
<definition>
<key>3</key>
<value>InitiatedByProvider</value>
</definition>
<createdOn>2018-02-05T09:54:08.7735183Z</createdOn>
<paymentStateDetails>
<detail xsi:type="keyStringValuePair">
<key>ProviderResponseMessage</key>
<value>OK</value>
</detail>
<detail xsi:type="keyStringValuePair">
<key>PaymentStateReasonID</key>
<value>1</value>
</detail>
</paymentStateDetails>
</state>
<isExecuted>false</isExecuted>
<baseAmount currencyCode="EUR">24.94</baseAmount>
<paymentDetails>
<detail xsi:type="keyStringValuePair">
<key>ProviderExternalID</key>
<value>2288</value>
</detail>
<detail xsi:type="keyStringValuePair">
<key>ProviderTransactionID</key>
<value>25213</value>
</detail>
</paymentDetails>
<paymentAccount>
<paymentAccountID>70a5c7a8-76da-4503-937d-faf0a331bccd</paymentAccountID>
</paymentAccount>
</payment>
</initiatePaymentResponse>
<initiatePaymentResponse xmlns="http://www.cqrpayments.com/PaymentProcessing" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<payment xsi:type="paymentWithPaymentAccount">
<merchantID>YourMerchant</merchantID>
<shopID>YourShop</shopID>
<paymentMethod>
<key>265</key>
<value>AstropayBankTransferWithdrawal</value>
</paymentMethod>
<merchantTransactionID>59715590-11-42</merchantTransactionID>
<paymentID>98858d51-cc27-49e1-a036-505bf89f137f</paymentID>
<userID>ygtest_SBCOM_BRL</userID>
<paymentProvider>
<key>152</key>
<value>Astropay</value>
</paymentProvider>
<amount currencyCode="PEN">100.00</amount>
<creationType>
<key>1</key>
<value>User</value>
</creationType>
<userIP>179.108.166.2</userIP>
<state>
<id>9122d0e4-b161-4474-934b-bc3ebbfa29ff</id>
<definition>
<key>3</key>
<value>InitiatedByProvider</value>
</definition>
<createdOn>2018-02-05T09:54:08.7735183Z</createdOn>
<paymentStateDetails>
<detail xsi:type="keyStringValuePair">
<key>ProviderResponseMessage</key>
<value>OK</value>
</detail>
<detail xsi:type="keyStringValuePair">
<key>PaymentStateReasonID</key>
<value>1</value>
</detail>
</paymentStateDetails>
</state>
<isExecuted>false</isExecuted>
<baseAmount currencyCode="EUR">24.94</baseAmount>
<paymentDetails>
<detail xsi:type="keyStringValuePair">
<key>ProviderExternalID</key>
<value>2288</value>
</detail>
<detail xsi:type="keyStringValuePair">
<key>ProviderTransactionID</key>
<value>25213</value>
</detail>
</paymentDetails>
<paymentAccount>
<paymentAccountID>70a5c7a8-76da-4503-937d-faf0a331bccd</paymentAccountID>
</paymentAccount>
</payment>
</initiatePaymentResponse>
<initiatePaymentResponse xmlns="http://www.cqrpayments.com/PaymentProcessing" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<payment xsi:type="paymentWithPaymentAccount">
<merchantID>PG</merchantID>
<shopID>releaseb</shopID>
<paymentMethod>
<key>265</key>
<value>AstropayBankTransferWithdrawal</value>
</paymentMethod>
<merchantTransactionID>59715590-12-11-313</merchantTransactionID>
<paymentID>b58e1f0a-bde7-4f1e-aad2-4f49ad6331d2</paymentID>
<userID>ygtest_SBCOM_BRL</userID>
<paymentProvider>
<key>152</key>
<value>Astropay</value>
</paymentProvider>
<amount currencyCode="COP">1000</amount>
<creationType>
<key>1</key>
<value>User</value>
</creationType>
<userIP>179.108.166.2</userIP>
<state>
<id>d049f140-1b0e-4c0f-933c-930986d291fd</id>
<definition>
<key>3</key>
<value>InitiatedByProvider</value>
</definition>
<createdOn>2020-01-28T08:27:18.6162134Z</createdOn>
<description>OK</description>
<paymentStateDetails>
<detail xsi:type="keyStringValuePair">
<key>ProviderResponseMessage</key>
<value>OK</value>
</detail>
<detail xsi:type="keyStringValuePair">
<key>PaymentStateReasonID</key>
<value>1</value>
</detail>
</paymentStateDetails>
</state>
<isExecuted>false</isExecuted>
<baseAmount currencyCode="EUR">0.39</baseAmount>
<paymentDetails>
<detail xsi:type="keyStringValuePair">
<key>ProviderTransactionID</key>
<value>52716f7e-53bb-436a-a547-872e8edf045c</value>
</detail>
<detail xsi:type="keyStringValuePair">
<key>ProviderExternalID</key>
<value>3458</value>
</detail>
</paymentDetails>
<paymentAccount>
<paymentAccountID>ba49550b-2769-4ef3-ad1c-e9f04e347f1f</paymentAccountID>
</paymentAccount>
</payment>
</initiatePaymentResponse>
<initiatePaymentResponse xmlns="http://www.cqrpayments.com/PaymentProcessing" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<payment xsi:type="paymentWithPaymentAccount">
<merchantID>DemoMerchant</merchantID>
<shopID>DemoShop</shopID>
<paymentMethod>
<key>265</key>
<value>AstropayBankTransferWithdrawal</value>
</paymentMethod>
<merchantTransactionID>hctest002013514</merchantTransactionID>
<paymentID>0b1129d1-d3fb-45c6-8545-3c933fdc594f</paymentID>
<userID>55517534-03</userID>
<paymentProvider>
<key>152</key>
<value>Astropay</value>
</paymentProvider>
<amount currencyCode="COP">40000</amount>
<creationType>
<key>1</key>
<value>User</value>
</creationType>
<userIP>10.8.60.57</userIP>
<state>
<id>a1f9404e-2007-4dbc-80a8-2258eee49c51</id>
<definition>
<key>3</key>
<value>InitiatedByProvider</value>
</definition>
<createdOn>2024-01-03T09:12:13.9357329Z</createdOn>
<paymentStateDetails>
<detail xsi:type="keyStringValuePair">
<key>ProviderResponseMessage</key>
<value>OK</value>
</detail>
<detail xsi:type="keyStringValuePair">
<key>PaymentStateReasonID</key>
<value>1</value>
</detail>
</paymentStateDetails>
</state>
<isExecuted>false</isExecuted>
<baseAmount currencyCode="EUR">15.42</baseAmount>
<paymentDetails>
<detail xsi:type="keyStringValuePair">
<key>UserFirstname</key>
<value>PPPPBOLETOFN</value>
</detail>
<detail xsi:type="keyStringValuePair">
<key>UserLastname</key>
<value>PPPPBOLETOLN</value>
</detail>
<detail xsi:type="keyStringValuePair">
<key>ProviderTransactionID</key>
<value>244402</value>
</detail>
<detail xsi:type="keyStringValuePair">
<key>ProviderExternalID</key>
<value>20672</value>
</detail>
</paymentDetails>
<paymentAccount>
<paymentAccountID>e4ab9ba8-bb4c-4e92-a5be-f6a5b5206c3e</paymentAccountID>
</paymentAccount>
</payment>
</initiatePaymentResponse>
The payment can reach one of the following states in the initiatePaymentResponse:
| Payment States | Description |
|---|---|
| InitiatedByProvider | Intermediate state denoting a successful payment submission at provider |
| WithdrawErrorReportedByProvider | Error state due to failed payment submission at provider; errors are logged in the PaymentStateAdditionalDetails fields ProviderErrorCode and ProviderErrorMessage |
| RefusedByProvider | Error state for a rejected payment; errors are logged in the PaymentStateAdditionalDetails field ProviderResponseMessage, ProviderStatusCode and ProviderStatusDescription. |
Submitted payments are sent by Astropay to the bank. Once they are confirmed by the bank, Astropay sends a notification to PXP Financial. PXP Financial queries the Astropay system for the status of the payment and update the payment state on PXP Financial side.
An AstropayBankTransferWithdrawal payment will have the following flow (described in provider terms and PXP Financial payment service states):
Pending (state InitiatedByProvider) => Delivered (state PendingOnProvider) => Confirmed (state WithdrawnByProvider) or Rejected (state RefusedByProvider).
A payment can also go from Pending (state InitiatedByProvider) or Delivered (state PendingOnProvider) to Cancelled (state Cancelled).
| Payment States | Description |
|---|---|
| PendingOnProvider | A withdrawal payment has been sent to provider ("Delivered"), but not yet processed and it still can be rejected |
| WithdrawnByProvider | Success state |
| RefusedByProvider | Error state due to failed processing of payment; errors are logged in the PaymentStateAdditionalDetails field ProviderResponseMessage, ProviderStatusCode and ProviderStatusDescription. |
| QueryPaymentStateErrorReportedByProvider | When PXP Financial receives a state change notification from provider Astropay, the state of the payment is being queried against provider. This error appears very rarily. |
Notification for RefusedByProvider
On a rejected payment errors are logged in the PaymentStateAdditionalDetails field ProviderResponseMessage, ProviderStatusCode and ProviderStatusDescription on the state RefusedByProvider:
| State | ProviderResponseMessage | ProviderStatusCode | ProviderStatusDescription |
|---|---|---|---|
| RefusedByProvider | Rejected | 800 | Invalid bank account |
| RefusedByProvider | Rejected | 807 | Rejected by bank |
| RefusedByProvider | Rejected | 812 | Bank account is blocked |
| RefusedByProvider | Rejected | 813 | Beneficiary document doesn't match bank details |
| RefusedByProvider | Rejected | 818 | The bank account is unable to receive transfers |
| RefusedByProvider | Rejected | 827 | The bank is not licensed to process this transaction |
Example handlePaymentStateChangedNotificationRequest for RefusedByProvider:
<handlePaymentStateChangedNotificationRequest xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://www.cqrpayments.com/PaymentProcessing">
<payment xsi:type="paymentWithPaymentAccount">
<merchantID>B2BTestMerchant</merchantID>
<shopID>AstropayCardBankTransferWithdrawalShop</shopID>
<paymentMethod>
<key>265</key>
<value>AstropayBankTransferWithdrawal</value>
</paymentMethod>
<merchantTransactionID>17593196-f44f-4b1e-92e8-474d8e88710d</merchantTransactionID>
<paymentID>c2c83321-1466-4af7-bde3-d84418f9b991</paymentID>
<userID>12b140b5-35ee-4a83-9f87-9d4405</userID>
<paymentProvider>
<key>152</key>
<value>Astropay</value>
</paymentProvider>
<amount currencyCode="BRL">10.0000</amount>
<creationType>
<key>1</key>
<value>User</value>
</creationType>
<userIP>127.0.0.1</userIP>
<state>
<id>6ca51370-bac8-42da-8121-1627a34289cd</id>
<definition>
<key>100</key>
<value>RefusedByProvider</value>
</definition>
<createdOn>2017-09-08T09:58:29.783</createdOn>
<paymentStateDetails>
<detail xsi:type="keyStringValuePair">
<key>ProviderResponseMessage</key>
<value>Rejected</value>
</detail>
<detail xsi:type="keyStringValuePair">
<key>ProviderStatusCode</key>
<value>812</value>
</detail>
<detail xsi:type="keyStringValuePair">
<key>ProviderStatusDescription</key>
<value>Bank account is blocked</value>
</detail>
</paymentStateDetails>
</state>
<isExecuted>true</isExecuted>
<baseAmount currencyCode="EUR">2.6500</baseAmount>
<paymentDetails>
<detail xsi:type="keyStringValuePair">
<key>ProviderExternalID</key>
<value>c2c83321-1466-4af7-bde3-d84418f9b991</value>
</detail>
<detail xsi:type="keyStringValuePair">
<key>BankReferenceID</key>
<value>513512.04198.5</value>
</detail>
<detail xsi:type="keyStringValuePair">
<key>ProviderTransactionID</key>
<value>8ef0c159-966e-43e1-a0ba-62661d72fc47</value>
</detail>
</paymentDetails>
<paymentAccount>
<paymentAccountID>d52b9f0e-55b3-4011-a5e7-3935c6388958</paymentAccountID>
</paymentAccount>
</payment>
</handlePaymentStateChangedNotificationRequest>
Notification for WithdrawnByProvider
The standard notification mechanism is used for notifying the merchant in the background (asynchronously) about payment state changes. For more information see PaymentStateChangedNotification.
Example handlePaymentStateChangedNotificationRequest for WithdrawnByProvider:
<handlePaymentStateChangedNotificationRequest xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://www.cqrpayments.com/PaymentProcessing">
<payment xsi:type="paymentWithPaymentAccount">
<merchantID>B2BTestMerchant</merchantID>
<shopID>AstropayCardBankTransferWithdrawalShop</shopID>
<paymentMethod>
<key>265</key>
<value>AstropayBankTransferWithdrawal</value>
</paymentMethod>
<merchantTransactionID>17593196-f44f-4b1e-92e8-474d8e88710d</merchantTransactionID>
<paymentID>c2c83321-1466-4af7-bde3-d84418f9b991</paymentID>
<userID>12b140b5-35ee-4a83-9f87-9d4405</userID>
<paymentProvider>
<key>152</key>
<value>Astropay</value>
</paymentProvider>
<amount currencyCode="BRL">10.0000</amount>
<creationType>
<key>1</key>
<value>User</value>
</creationType>
<userIP>127.0.0.1</userIP>
<state>
<id>6ca51370-bac8-42da-8121-1627a34289cd</id>
<definition>
<key>20</key>
<value>WithdrawnByProvider</value>
</definition>
<createdOn>2017-09-08T09:58:29.783</createdOn>
<paymentStateDetails>
<detail xsi:type="keyStringValuePair">
<key>ProviderResponseMessage</key>
<value>Completed</value>
</detail>
</paymentStateDetails>
</state>
<isExecuted>true</isExecuted>
<baseAmount currencyCode="EUR">2.6500</baseAmount>
<paymentDetails>
<detail xsi:type="keyStringValuePair">
<key>ProviderExternalID</key>
<value>c2c83321-1466-4af7-bde3-d84418f9b991</value>
</detail>
<detail xsi:type="keyStringValuePair">
<key>BankReferenceID</key>
<value>513512.04198.5</value>
</detail>
<detail xsi:type="keyStringValuePair">
<key>ProviderTransactionID</key>
<value>8ef0c159-966e-43e1-a0ba-62661d72fc47</value>
</detail>
</paymentDetails>
<paymentAccount>
<paymentAccountID>d52b9f0e-55b3-4011-a5e7-3935c6388958</paymentAccountID>
</paymentAccount>
</payment>
</handlePaymentStateChangedNotificationRequest>
Testing instructions
Identification Numbers for Astropay
| Country | IdentificationNumber (sample values for testing) | IdentifcationNumberType |
|---|---|---|
| Brazil | Test data for CPF or CNPJ here | Do not send any value. |
| Chile | Test data for RUT here (11 digits) | Do not send any value |
| Peru | DNI: 58324956 RUC: 48531120453 PASS: 595601234865 CE: 433450978123 | Send DNI, RUC, PASS or CE. |
| Mexico | sending is optional CURP or RFC or IFE number | sending is optional |
| Columbia | For CC eg. 1058324956 | type CC. |
Bank account data for Astropay:
| Country | AccountNumber | BranchCode | BankSortCode | AccountType |
|---|---|---|---|---|
| Brazil | 88365484 | 7197 | C | |
| Chile | 9795493 | 001 | C | |
| Peru | 00159687395013948567 | 113 | C | |
| Mexico | 032180000118359719 | 032 | - | |
| Columbia | 0321800001183597 | 001 |
BankTransferWithdrawalReturn
In case a bank transfer withdrawal is returned, then a new payment of type BankTransferWithdrawalReturn is created and merchant is notified.
Sample notification with payment method BankTransferWithdrawal
<?xml version="1.0" encoding="utf-8"?>
<handlePaymentStateChangedNotificationRequest xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns="http://www.cqrpayments.com/PaymentProcessing">
<payment xsi:type="paymentWithPaymentAccount">
<merchantID>xxx</merchantID>
<shopID>xxx</shopID>
<paymentMethod>
<key>265</key>
<value>AstropayBankTransferWithdrawal</value>
</paymentMethod>
<merchantTransactionID>e2934084-ce2d-4d57-bd0f-81a0983fbf49</merchantTransactionID>
<paymentID>de6524a5-44c8-440e-8fb9-bda0ccf59301</paymentID>
<userID>f782088e-0d3e-402b-9143-359be4</userID>
<paymentProvider>
<key>152</key>
<value>Astropay</value>
</paymentProvider>
<amount currencyCode="BRL">10.0300</amount>
<creationType>
<key>1</key>
<value>User</value>
</creationType>
<state>
<id>434bae34-630a-4b6f-9c00-faa0c5c5adf2</id>
<definition>
<key>279</key>
<value>ReturnedByProvider</value>
</definition>
<createdOn>2021-04-07T15:40:31.79</createdOn>
<paymentStateDetails>
<detail xsi:type="keyStringValuePair">
<key>ProviderResponseMessage</key>
<value>Rejected</value>
</detail>
</paymentStateDetails>
</state>
<isExecuted>true</isExecuted>
<baseAmount currencyCode="EUR">2.6600</baseAmount>
<paymentDetails>
<detail xsi:type="keyStringValuePair">
<key>ProviderExternalID</key>
<value>de6524a5-44c8-440e-8fb9-bda0ccf59301</value>
</detail>
<detail xsi:type="keyIntValuePair">
<key>MerchantSettlementCurrencyID</key>
<value>2</value>
</detail>
<detail xsi:type="keyStringValuePair">
<key>OriginalPaymentID</key>
<value>de6524a5-44c8-440e-8fb9-bda0ccf59301</value>
</detail>
<detail xsi:type="keyStringValuePair">
<key>OriginalPaymentMerchantTransactionID</key>
<value>e2934084-ce2d-4d57-bd0f-81a0983fbf49</value>
</detail>
<detail xsi:type="keyStringValuePair">
<key>OriginalPaymentMethodID</key>
<value>265</value>
</detail>
<detail xsi:type="keyStringValuePair">
<key>OriginalPaymentMethodName</key>
<value>AstropayBankTransferWithdrawal</value>
</detail>
</paymentDetails>
<paymentAccount>
<paymentAccountID>1d9ca158-38ce-4270-8d53-cbab137254df</paymentAccountID>
</paymentAccount>
</payment>
</handlePaymentStateChangedNotificationRequest>
Updated 4 months ago