믹서
시작하기 전에 결제프로세스 믹스정보 믹스생성
시작하기 전에 비트코인 믹서 API를 연동하기 전에 먼저 알아둬야 하는 내용입니다.
비트코인 믹서API를 사용하기 위해선 별도의 제휴가 필요합니다.
비트코인 믹서 파트너 어드민으로 접속하여 안내에 따라 제휴프로세스를 진행할 수 있습니다.
Error Code
이름 내용
204 믹서주소가 존재하지않을 경우
20001 수수료 정보가 존재하지않을 경우
20002, 20003 믹서 후 입금될 주소가 존재하지않을 경우
20004 믹서 분배비율이 누락된 경우
20005 믹서 지연시간이 누락된 경우
21001 수수료 설정 범위 초과 0.2~3을 초과한 경우
21002 믹서 후 입금될 주소 최대10개를 초과한 경우
21003 믹서후 입금될 주소가 잘못된 경우
21004 믹서 지연시간 10분~72시간을 초과한 경우
21005 믹서 분배비율이 100으로 설정되어야합니다.
30001,30002 지갑생성중 오류가 발생하였습니다.
결제에 필요한 필수 값
이름 내용
api_token 가맹점 코드 60자.
PAYMENT PROCESS 비트코인 믹서 결제 프로세스를 간략하게 설명합니다.
Step 1.

믹서된 비트코인을 받을 주소를 설정합니다.

- 1개 ~ 최대 10개 까지 비트코인 주소를 설정 가능합니다.

- 지연시간을 설정 및 기본 값으로 사용합니다.

Step 2.

결제용 비트코인 주소에 돈을 입금합니다.

- 믹서가 완료될때까지 기다립니다.

MIX정보

비트코인의 믹스진행정보를 JSON 형태로 반환합니다

비트코인 먹서 API는 api_token을 이용하여 요청 가능합니다. api_token의 키가 탈취되는 일이 없도록 주의하시기바랍니다.

Request

GET /api/v1/mixer/{wallet_id} HTTP/1.1

Authorization: 'Authorization' => 'Bearer {api_token}'

Content-type: application/x-www-form-urlencoded;charset=utf-8

Host: apiServerAddress

사용자토큰을 헤더에 담아 GET로 요청합니다.

예를 들어, 믹서 상태를 테스트 해보고 싶다면 다음과 같이 요청합니다.

curl -v -X GET 'https://apiServerAddress/api/v1/mixer/{wallet_id}' \

-H 'Authorization: Bearer {api_token}'

Response

요청이 성공하면 응답 바디에 JSON 객체로 아래의 값을 포함합니다.

내용 타입
state 현재 믹서진행 상태 int
wallet>balance 사용자가 입금한 금액 Float
wallet>fees 사용자가 설정한 수수료율 Float
deposit_waiting 입금 대기 시간 Float
confirm_date 입금확정 컨펌된 시간 Date
output>address 받을비트코인주소 String
output>ratio 받을비율 Float
output>waiting_time_minute 대기시간(분단위) Date
output>remittance_date 받게될시간 Date

HTTP/1.1 200 OK

Content-type: application/json;

{
    "state":"Deposit_Waiting",
    "data":{
    "wallet":{
    "balance":0,
    "fees":0.3
    },
    "deposit_date":null,
    "confirm_date":null,
    "output":[
        {
        "address":"3MB3j2aPkzuRzsca2A1Ag152EUq3V9hUHc",
        "ratio":48,
        "waiting_time_minute":35,
        "remittance_date":null
        },
        {
        "address":"3BKKW4iH6GVpzDQczzeQJhzTqb6Z3kzjmH",
        "ratio":52,
        "waiting_time_minute":18,
        "remittance_date":null
        }
    ]
    }
}
                
MIX생성

발급받은 api_token을 사용하여 비트코인 믹서용 API를 호출해 진행합니다.

비트코인 먹서 API는 api_token을 이용하여 요청 가능합니다. api_token의 키가 탈취되는 일이 없도록 주의하시기바랍니다.

Request

GET /api/v1/mixer/{wallet_id} HTTP/1.1

Authorization: 'Authorization' => 'Bearer {api_token}'

Content-type: application/x-www-form-urlencoded;charset=utf-8

Host: bitcoinmixer.io

사용자토큰을 헤더에 담아 GET로 요청합니다.

예를 들어, 믹서 상태를 테스트 해보고 싶다면 다음과 같이 요청합니다.
아래 예제는 라라벨 프레임워크를 기반으로 작성되었습니다.

$response = $http->request('post', 'https://apiServerAddress/api/v1/mixer', 
[
    'headers' => 
    [
        'Accept' => 'application/json',
        'Authorization' => 'Bearer '. '{api_token}',
    ],
    'form_params' => 
    [
        'fees' => 0.3,
        'output' => 
        [
            [
                'address' => '3MB3j2aPkzuRzsca2A1Ag152EUq3V9hUHc',
                'ratio' => 48,
                'waiting_time_minute' => 35
            ],				
            [
                'address' => '3BKKW4iH6GVpzDQczzeQJhzTqb6Z3kzjmH',
                'ratio' => 52,
                'waiting_time_minute' => 18
            ],
        ]
    ],
]);
                
Response

요청이 성공하면 응답 바디에 JSON 객체로 아래의 값을 포함합니다.

내용 타입
wallet>id 고유번호 int
wallet>address 믹서용 비트코인 입금 주소 Float

HTTP/1.1 200 OK

Content-type: application/json;

{

      "wallet":
      {
          "id": 53,
          "address": "3AY33t6npow3E4Ky3Nod49jDNqxHFYXvpL"
      }

}